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A. INTRODUCTION 


QP/M 2.7 is a superset of CP/M 2.2. It is intended to 
upgrade any CP/M system which uses a Z80 or NSC-800 
microprocessor, to a faster, more powerful operating systen. 
Original CP/M packages include the CCP (Command Control 
Processor) and BDOS (Basic Disk Operating System). The CP/M 2.2 
CCP has been totally replaced by an upgraded version called QCP 
which includes a most important TIME command; CP/M 2.2 BDOS has 
been replaced by QP/M 2.7 QDOS. Two new unique features appear 
in QDOS: Drive and User Search whenever a file is opened, and 
automatic time/date stamping of files. Your original CP/M 2.2 
BIOS (Basic Input/Output System) can be used as is; however, in 
order to use the time/date capability, a new vector (called 
TIMDAT) must be patched into your system somewhere to return the 
current date and time. (This vector does not have to be in 
BIOS.) Specific procedures can be found in this documentation. 


If you have purchased one of the QBIOS packages with QP/M, 
you only need to refer to section D if you wish to change the 
default settings of QP/M. The remaining sections may be ignored. 


B. RESTRICTIONS 


QP/M is fully compatible with the CP/M 2.2 operating system. 
However, there are some restrictions imposed in order to run 
.QP/M: 

(1) You should have a minimum of 32k of memory in your 
system. This restriction is imposed by the QINSTALL program as 
two complete system images plus loaders must exist together in 
memory during installation. If you have a smaller system and are 
the adventurous type, you can try to install QP/M; depending on 
your SYSGEN program, it may or may not work. 


(2) You should currently be running CP/M 2.2. Although 
MICROCode does support some systems with an optional BIOS package 
that eliminates the requirement for CP/M 2.2, the list is limited 
(though growing). QP/M replaces only the BDOS and CCP portions 
of CP/M. You will still need the BIOS and system specific 
utilities such as SYSGEN and INIT. Contact MICROCode Consulting 
directly to determine if your system is directly supported with 
QBIOS and QBOOT modules. 
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(3) Unless your machine is specifically supported, you will 
need to have some knowledge in programming in order to establish 
the QP/M-to-real-time-clock connection. If you are unable to do 
this, the time/date stamping feature of QP/M will be disabled. 
If you purchased QP/M solely for this purpose, contact MICROCode 
for return shipping instructions to obtain a full refund. 


C. BEFORE INSTALLATION 


Your BIOS configuration determines how the default 
drive/user is set within QCP and if the QCP can be preset to 
execute a command/program on cold boot. If your BIOS supports 
the execution of a program on "cold" boot (called auto-boot), 
then it is configured correctly. If not, it is recommended that 
auto-boot capability be added. 


Upon "cold" entry into QCP (at location QCP + 0000H), QDOS 
is set to an initial default drive/user (specified during 
installation via QINSTALL), and any autoboot command/program will 
be executed. Should you decide to change the default drive 
and/or user, QCP modifies the memory locations associated with 
these values. Upon "warm" entry into QCP (at location QCP + 
0003H), QDOS is reset to the most recent values of default 
drive/user specified in the QCP. (The auto-voot command/program 
will NOT be executed). 


In order for your BIOS to support auto-boot capability, the 
BIOS must use the "cold" entry into QCP during cold boot and use 
the "warm" entry thereafter. 


If your BIOS does not support auto-boot, you cannot use all 
of QP/M's capability. The disadvantage is that upon every cold 
AND warm boot, QDOS is set back to the initial default drive/user 
as specified during QINSTALL. Even worse, if you have specified 
an initial command/program for QCP, EVERY warm boot will repeat 
the command/program. 


A more important feature to implement is the QP/M-to-real- 
time-clock interface. In order to have FULL time/date capability 
with QP/M, your system must support a real-time clock in either 
hardware or software. To interface with QP/M, a jump vector 
called TIMDAT must be set up (anywhere in memory) to return the 
address of the "clock string" in register pair HL. The "clock 
string" is defined as a 6-byte string as follows: 


HL +0 20+l +2 +3 +4 +5 
day month year hour min sec 
These values must be in binary with the time in 24-hour format. 
For example, March 17, 1985 at 6:12 p.m. would be expressed as: 
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HL +0 +1 +2 +3 +4 +5 
(decimal) 17 03 85 18 12 00 


For example, let's assume that the system has a software clock 
located at OF504H and there are 7 bytes free at OFF79H. The code 


would be as follows: 


TIMDAT: 
FF79: JMP FF7C 
FF7C: LXI H,F504 
FF7F: RET / 
/ 


Note the jump vector 
instruction of a TIMDAT routine. 
not every system supports a real-time clock, or, 
important, that a required clock module has not been loaded from ! 
disk yet, QDOS examines the first byte of the TIMDAT routine. 
it ts NOT a JMP (0C3H) instruction, the clock is considered 


missing. 


Since MICROCode realizes that 


(at FF79H), which is always the first | 
even more! 
{ 


If you are currently running a software updated clock on 
your system, your QP/M TIMDAT routine should perform any 
conversion, if necessary, into binary format and place the values 


in the order listed above. 


Since there are a variety of hardware clocks available on 
the market, MICROCode Consulting has not tested QP/M with every 
package. Your QP/M TIMDAT routine should read the current 
time/date from the hardware and convert it into the QP/M format 
in memory. Contact MICROCode Consulting directly to determine if 
there is a TIMDAT routine already written for your particular 


hardware. 


D. USING QINSTALL . 


Before running QINSTALL, you need to determine the user- 
definable values. This is most easily done by previewing the 
QINSTALL program options as they appear during actual operation. 
Take your time and understand what each value means. That way, 
the first execution of QINSTALL will take only a minute or two, 
and you will be running under QP/M in no time. 


Note that you should have your SYSGEN program (could be 
another name) on a disk that is in your system. Since QINSTALL 
could not possibly support every CP/M machine available, it uses 
your original SYSGEN program to create the new systen. Of 
course, once you have created QP/M on one of your disks, SYSGEN 
can be used, as always, to transfer the system to other disks. 
QINSTALL should only be run for first time installation or when 
you wish to change the user-definable values. 
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When you are ready, take a few minutes to review the QINSTALL *) 


options shown below. Each option is listed, 


along with the 


default values. The blank column to the right can be used to fill 


in your own values. 


KKK QCP System Installation settings 


<O> Number of LlineS ON SCTEEN  ceveeereccrscceee 
<1> Show user number when user is zero ........ 


<2> Operating as Remote Access System 
(Disable all transient commands) ........ 


_ <3> Pause when screen fills during TYPE ....... 
<4> Printer top-of-form character (decimal) ... 
<5> “Prompt while SUBMIT or QSUB is active ..... 
<6> Standard QP/M prompt we. cceeeeeec ee cccevees 
<7> Maximum user number allowed by QCP ........ 


<8> Show SY¥Stem files in DIR listing .......... 


aR*KK 


Default New Value 


scecccese 24 


eeeeevee YES 


eeeseese 12 

tier evereas:, 9 

ee eeeee PD 

ies Oo 
eeeeeee NO 


<9> Separator character between files listed with DIR... : 


<A> Initial default drive setting ...........0.- 


<B> Initial default user setting .... ses eeeeaee 


<C> Word (l6-bits) to hold default drive and user at ... OOO8H 


<D> Initial program/command to execute: <none> 


What the options mean: 


<O> Enter the vertical height of your screen in lines. This 
value is only used to determine pause position during a TYPE 


command. 


<1> QCP displays the user number after the drive letter when the 


QCP will always oO 


current user area is not zero. Optionally, 
show the user number when set to YES. 


<2> 


<3> 


<4> 


<5> 


<6> 


<7> 


<8> 


<9> 


<A> 


<B> 


<C> 


<D> 
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If you are running your system as a Remote System, setting 
this value to YES will disable all transient QCP commands. 


When TYPEing a file under QCP, it will normally wait after 
the page is full. Pressing any key will resume printing of 
the next page, and so on. Setting this value to FALSE will 
result in no pauses unless the 'P' option of TYPE is used. 


Most printers use 12: decimal (ODH, 'FF' or FormFeed in 
ASCII) as the top-of-form character. This value is sent to 
the printer whenever the TOF transient command is executed. 


Prompt when a SUBMIT file has control of the console during 
QCP operations (e.g. ASMAINMENU). 


Prompt during normal (user) console entry of QCP (A>, B>). 


Maximum user number allowed with the USER command. Can be 
changed to protect higher user areas during normal 
operation. 


Normally, the transient DIR command does notdisplay files 
tagged as SYStem. If this value is set to YES, DIR will 
also display files which have a SYStem tag. 


Separator character used between files displayed on the 
screen when using the DIR or ERA command. 


Default drive set upon "cold" entry into QCP. Can be any 
drive A through 0 or disabled. This value is used by QDOS 
when searching for files. 


Default user set upon "cold" entry into QCP. Can be any 
user between 0 and 14 or disabled. This value is used by 
QDOS when searching for files. 


Address of 2-byte (word) value which holds the default drive 
and user. This is used by the QCP during warm boot to 
restore default drive and user to the value last specified 
by the transient DFU and DFD commands. This value will 
normally be left as is; however, if this location conflicts 
with other parts of your system, you have the option of 
locating the default values elsewhere in memory. 


Use this option to specify a command that is executed on 
each "cold" entry into QCP. If your BIOS does NOT have 
auto-boot capability, do NOT enter any command as it will be 
re-executed on EVERY warm boot. Maximum character length is 
40. 


a 
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The other area of QP/M that has user-definable values is the 
QDOS. The QDOS "image" inside QINSTALL is shipped with values 
that will allow QP/M to run on an un-modified CP/M system. Each 
option is listed below along with the default values. The blank 
column to the right is an aid for filling in your own values. 


aK QDOS System. Installation settings KK 
Default New Value 
<O> Save character obtained during console scan .. YES 
<1> BIOS supports BDOS error code table .......... NO 


<2> Address of time/date jump vector .......+6.2+e++- DISABLED 


What the options mean: 


<O> When characters are being sent TO the console, a check is 
made for a CTRL+S FROM the console. A CTRL+S puts QDOS into 
a loop until another character is pressed; both CTRL+S and 
the additional character are always discarded. However, if 
a key other than a CTRL+S is pressed, the choice you make 
will determine what happens: 


YES: This will save the character until the next console input 
request. This setting is recommended for interrupt-driven 
console input to allow type-ahead. However, since QDOS can 
only hold one character at a time, typing a non-CTRL+S 
character will disable CTRL+S checking until that character 
is read via a console input call. 


NO: This will discard the character. This setting is 
recommended for a non-interrupt-driven console input. The 
advantage here is that typing any character other than a 
CTRL+S will not disable the CTRL+S check which can occur 
with YES. 
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<1> During disk operations (read/write), BIOS returns an error 
code in the A-~register. A value of OOH means success, any 
other value means an error occurred. 
If your BIOS does not support the disk error protocol, then 
all. read/write errors give the message "QDOS error on d: Bad 
\ 


Sector", since QDOS only checks for a zero/non-zero value. \ 
If your BIOS supports the disk error protocol, then Qpos \ 
uses the value in the A-register to give a more specific 


No error 
+ Bad Sector - permanent error found 


0 
1: 
2: Select Error - drive not ready 

3: R/O - drive is read-only (write protected) 


register A = 


. 
: 


If your BIOS supports the BDOS disk error protocol, then 
answer YES. If it does.not or you are not sure, then answer 


NO. 


<2> This option is used to enter the location of the real-time 
clock-to-QP/M interface vector (TIMDAT). Owners of QBIOS 
will find a table in Section A of the QP/M Supplement 
containing the address for their system. If you do not have 
QBIOS, you will have to enter your own value. Note that a 
value of zero is designated as disabling the QP/M-to-real- 


time-clock interface. 


Once all of the user-definable values have been set, 


QINSTALL will generate a system size the same as that you are 


currently running. When you see the message 


Press <C> to continue or <A> to abort 


QINSTALL is ready to proceed.with the actual system installation. 
If special instaflation is required due to QINSTALL not finding 
the system image, or if you wish to specify adifferent size QP/M 
System than the current one, you would type the special 
installation option at this point. Otherwise, press <C> and 
QINSTALL runs your SYSGEN program. 


When you enter the SYSGEN program the first time, you should 


instruct SYSGEN to read the system image from a bootable disk. 
DO NOT continue 


Once you have finished reading the system image, DO 
and write the system image as QP/M has not been installed yet. 
Instead, do a normal EXIT from the SYSGEN program and QINSTALL 


will resume control. At this point, a message like 


System image found at xxxxH 
a message will be displayed 


should appear. If it does not, 
If this happens, 


informing you the system image was not found. 
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it is either because the system image on disk is different than 
the one currently running, the image is not located on a page 
(256-byte) boundary, or the system tracks of the disk you just 
read do not contain a system. In any case, you should run 
QINSTALL again using another disk which contains a system. If 
QINSTALL fails to find the image again, experienced users should 
refer to sections E and F for further help. Otherwise, contact 
MICROCode Consulting for technical help. 


Once the previous system image has been found, QINSTALL 
overlays the QP/M portions into the system image. The message 


Press <C> to continue or <A> to abort 


will appear. You must now instruct your SYSGEN program to write 
the system image (do NOT read again). QP/M is now installed on 
your disk. You can now use your SYSGEN program normally to move 
QP/M from this disk to any other disks just as you would CP/M. 


NOTE: After QINSTALL overlays QP/M into your system image and 
SYSGEN is re-executed, you should NOT read the system image 
again since it already exists in memory. Reading the system 
image will destroy the QP/M image and you will have to start the 
QINSTALL process over again. Most SYSGEN programs give a message 
iike 


Enter source drive (RETURN to skip) 


You should press <RETURN> since the image is in memory and 
proceed with writing the image onto the destination drive. 
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E. SPECIFYING THE SYSTEM IMAGE ADDRESS 


Normally, QINSTALL searches for the system image 
automatically, to accomodate the wide variety of SYSGEN programs 
which have images at unknown addresses. If for some reason 
QINSTALL failed to find the system image, it is possible to force 
QINSTALL to put the QP/M image at any arbitrary address. 
However, you MUST be sure of the system image address or QP/M 
will not be installed properly. Execute QINSTALL up to the 
message: 


Press <C> to continue -OR- <A> to abort -- 


Pressing <CTRL+F> will put QINSTALL into special installation 
mode; you will be prompted for the address. 


F. CREATING AN ARBITRARY SYSTEM SIZE 


This section of QINSTALL should only be selected if you wish 
to install a system size which is NOT the same as your current 
system size. Note that your BIOS and BOOT routines must also be 
changed as QINSTALL will not modify these. 


If you are not running CP/M 2.2 and wish to change system 
size, you must first modify the BIOS and BOOT of the system 
image, and then write it to disk with SYSGEN. (The system tracks 
are not usable yet.) In this case, it is likely you will have to 
specify the system image location (via <CTRL+F>) as well as the 
New system size. 


To specify an arbitrary system size, you must complete the 
normal QINSTALL process up to the message: 


Press <C> to continue -OR- <A> to abort -- 


Pressing <CTRL+U> will put QINSTALL into the user-definable 
System size mode. QP/M can be configured in 1/4k increments by 
first specifying the integer size, then the 1/4k size. Using 
this option does not affect the system image search, which is 
automatic. After generating the new system size, you will be 
returned to the normal QINSTALL procedure. 


If the installation is unsuccessful, you may first have to 
specify the system image address, as explained in section E. 
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G. QINSTALL SUMMARY 


BEFORE running QINSTALL, verify the following: 


(1) 


(2) 


(3) 


(4) 


(3) 


Minimum 32k memory size 


A jump vector TIMDAT has been set up in memory to 
return the address of the "clock string" in register 
pair HL 


QCP and QDOS installation options have been determined 
in advance 


SYSGENor similar program is on one of the available 
drives 


Size of the system located on the system tracks of your 
disk (which SYSGEN will read), and the operating system 
currently in memory are the same 
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A. INTRODUCTION 


QP/M is an optimized single-user operating system which was 
ereated using CP/M's BIOS structure and BDOS function calls as a 
root. All of the features of CP/M 2.2 are present; additional 
capability has been added for the three new features: time/date 
stamping, user search, and drive search. 


Included in this chapter is a description of the QP/M 
commands available at the user level. (Programmers will find the 
QP/M application level documentation in part III, QP/M Interface 
Guide.) This manual is not intended as a tutorial on QP/M. If 
you are a novice to this subject, it is strongly recommended that 
you purchase one of the several introductory books available on 


CP/M. 


The QCP (CCP replacement) portion of QP/M is a user-to-QDOS 
(BDOS replacement) interface having a number of useful transient 
commands, which are described in section C. For example, 
changing the user area (USER), listing the contents of a file on 
the terminal (TYPE), and displaying the directory contents of a 
drive (DIR) are all transient capabilities. 


A line entered at the terminal can be edited during entry; 
this is described in section B. 


Utilities provided with QP/M (depending upon the package 
purchased) are described in section D. 


During normal operation, QCP will display the drive, user, 
and the QCP prompt. For example, if you are located on drive A 
user 1, you would see ‘ 


Al> 


If you have configured your QCP to suppress display of user 
number when it is 0, the prompt wnen you are on drive C, user 0, 
would be 


C> 


When operating the CP/M 2.2 SUBMIT utility, tne prompt 
changes to ‘'dug$' or 'd$'. When QSUB is active, the prompt 
remains as 'du>' or 'd>'. It is a requirement that the SUBMIT 
temporary file ($$$.SUB) is always executed from drive A: even if 
the SUBMIT program (.SUB) was activated from another drive; 
section E contains the instructions for modifying CP/M's SUBMIT 
utility to be compatible with the QCP. 
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When QCP gives the prompt 'du>!' or 'd>' and QSUB is not 
active, the system is waiting for a command from the user. 
Transient commands can be directly executed at any time. 
Commands resident on disk are executable if they have the file 
extension (characters - up to three - located after the period) 
of 'COM'. 


A command-search hierarchy 1s implemented within QDOS; the 
QCP takes advantage of tnis feature when a command is entered as 
follows: 


- the user's command is checked against the QCP-resident 
(transient) commands and executed immediately if a match is 
found UNLESS the command is preceded by a drive designation 
(i.e. TIME will execute the transient command whereas B:TIME 
will not.) 


- failing that, the current user number on the current disk 
is scanned for the COM file; the COM file is loaded and 
executed if found 


- failing that, a default user number (usually 0 ) on the 
current disk is scanned for the COM file UNLESS default user 
search has been disabled; the COM file is loaded and 
executed if found 


- finally, failing that, the default user number on the 
default disk (usually A:) is scanned for the COM file UNLESS 
default drive search has been disabled; the COM file is 
loaded and executed if found or an error message (COMMAND?, 
where COMMAND was tne user's command name) is printed 


A more detailed description of the QDOS search procedure is 
presented in section F. 
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Pressing the keys shown below will determine what action 
should take place at the QP/M ">" prompt: 


<DELETE>/<RUBOUT>, = BACKSPACE 


<CTRLD> + 


++ ee ttt 


<C> 
<E> 
<H> 
<J> 
<M> 
<R> 
<U> 
<X> 


REBOOT SYSTEM (if done at beginning of line) 
END OF LINE 

BACKSPACE 

LINE FEED 

CARRIAGE RETURN 

RETYPE LINE 

DELETE LINE 

BACKSPACE to beginning of line 
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C. BUILT-IN COMMANDS 


C-1. Introduction 


The built-in commands of QP/M are an enhanced/modified 
version of ZCPR 1.0. Although most of the code was re-written to 
accomodate QP/M features, some of it has not been changed. 
Special thanks go to Richard Conn, Frank Wancho, Keith Peterson, 
and Ron Fowler who nave unknowningly inspired this complete 
replacement for CP/M 2.2. 


QP/M uses the standard CP/M file syntax of "FILENAME.EXT". 
A filename can be from one to eight characters, excluding special 
characters "<< >.,3: 2+? * {[ ] ", with no intervening spaces. 
An optional "extension" (up to three characters) can follow the 
filename, if preceded by a period (.). Only those files with an 
extension of ".COM" can be directly executed at the QP/M prompt 
(normally ">"). 


QP/M also recognizes "Wild Card" characters "?" and "#", 
These two symbols are used as follows: 


? is used to match any character of a filename in that 
same position, including blanks. Q???.COM would produce 
tnree matches if QCP.COM, QPIP.COM, and QSUB.COM files 
were on the referenced disk. QSTAT.COM would not be a 
match, as there are more characters in the filename 
than were specified by the "??7?", 


Another example of this wild card would be to svecify 
2DATA2??7?.785. This would search for all filenames at 
least five. characters long, with one cnaracter 
preceding "DATA", and extensions ending in "85". 


* is used as a "shortcut" to typing "?" througn the 
eighth character of the filename. Referencing the 
above examples, Q*.COM would be equivalent to typing 
Q2?77272?72?.COM and would find matches of QCP.COM, 
QSTAT.COM, and QSTAMP.COM. DATA*.8# would find matches 
in DATA111.855, DATA.854, or DATA-B.851. 


#.* is equivalent to ?77772277.272??, and will match all 
files. 
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The file reference conventions found below will be used 
throughout this section: 


ambiguous file reference 


afn - 
(Could reference one or more filenames.) 
ufn - unambiguous file reference 
(Can only reference one filename.) 
params = Optional parameters specified by the user, 


following a transient command or program name. 


Examples of params are: 


DIR Q*.COM 

WS DOCFILE 

QSTAT QSTAMP $R/O 
COMPARE A:DATA1 B:DATA1 


All commands are executed at the QP/M prompt ">", whenever 


the <RETURN> or <LINE FEED> keys are pressed. 


Optional parameters are surrounded by brackets '[]'; do not 
enter the brackets themselves. Lower case characters are 
translated into upper case when commands are executed. 
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DFD 


C-2. DFD [drive:] 


The DFD command sets the default drive to the drive 
specified; the drive letter must be followed by a colon. For 
example, to set drive B as the default drive, you would enter 


DFD B: 


41 with a valid default drive, or a cold boot. For example, the 
command 


DFD 


Will disable the drive search feature of QP/M. 
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DFLT 


C-3. DFLT 


DFLT prints: the active default drive and user at the 
terminal. For example, if the default drive is A and default 
user is 0, typing DFLT would result in 


AO 
oeing displayed. If the default user is disabled, no user number 
is displayed. If the default drive is disabled, '@' is displayed 
in place of the drive letter. 


Some examples are included below 


1 


AY <--- Default drive is A, default user is 4 

@1 <--- Default drive disabled, default user is 

Cc <--- Default drive is C, default user disabled 

@ <--- Both default drive and default user are 
disabled 
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c-4. DFU. [n] 


The DFU (Default User) command is identical in format to the 
USER command (described in section C-16) except 'n' specifies the 
Default User number to’be applied for user searches in QP/M. 
This new Default User number remains active until the next DFU 
command is issued, QDOS function 42 is called with a new Default 
User number, or a cold boot. Only values between 0 and 14 


(decimal) will set the default user area. A 'blank' implies User 


0. A value of 15 (OFH) disables the default user search within 


Qpos. Formats for DFU are 


DFU 13 <-- Set Default User number to 13 decimal 
DFU 15 <-- Disable Default User Search 
DFU <-- Set Default User number to 0 
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DIR f{afn] 


DIR 


The DIR (directory) command lists all matched files in the 
currently active user area on the specified (or default) drive. 


The "afn" is optional. 


DIR 


As a special case, the command 


lists all files in the currently active user area of the default 
disk. The command: 


DIR *.* 


is equivalent to the first command (DIR) as it specifies that all / 
matching files should be listed. 


a drive designator as shown below 


DIR 


DIR 
DIR 
DIR 


Q??2?.COM 


#.DOC 
B: 
C3:*.A2M 


Valid commands can also include 


Display all files Q.COM, Q?.COM, 
Q??.COM or Q??7?7.COM 

Display all files with extension DOC. 
Display all files on drive B 


Display all files with extension 
of A?M on drive C 
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c-6. ERA afn 


The ERA (erase) function removes all specified files on the 
default (or specified) drive. All files in the directory 
matching that file specification will be listed on the console. 
If any erase attempt is made to a file that is R/O (read only), a 
message 


QDOS error on d: File R/O 


will appear and the file will not be erased (even though it was 
listed on the console). Whenever a wild-card (* or ?) is used, 
several files matching the (afn) designation may be displayed on 
the console. However, the above message occurs (and the erase 
aborts) if and when the first R/O file is encountered. 
Unfortunately, there is no way of knowing which files that were 
listed on the console were actually erased, and which were not. 
Only by listing the directory will you be sure. 


The ERA command will remove both DIR and SYS files. This 
might include SYS files you do not normally see with the DIR 
command if your QCP is configured that way. Examples of valid 
commands are 


ERA TMP.1 <-- Erase TMP.1 

ERA *.BAK <-- Erase all files with extension .BAK 

ERA B:TEST.# <-- Erase all files on drive B with name of 
TEST, and any extensions 

ERA *.* <-- Erase all files 


This last command will erase all files on a specified drive. As 
a final confirmation that you really want to erase all files, QCP 
will prompt 

All? 


Entering a character other than "y" or "Y" will abort the erase 
command. 
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C-7. GET addr ufn 
from disk into memory 


The GET command loads the file 'ufn' 
starting at hexadecimal location 'addr'. GET employs the QDOS 
search path in finding the file. Valid commands are 
GET 3000 PROG.UTL <-- Load PROG.UTL into memory at 3000H 

<-- Load TEMP.TST into memory at 118H 


GET 118H TEMP.TST 
the file at the given 


If there is insufficient memory to load 


address, the message 


Full 
will be displayed and the GET will not be completed. 
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c-8. Go. [params] 


The GO command is a specialized case of the JUMP command 
where the address is always the start of the TPA (usually 100H). 
GO is equivalent to "JUMP 100H". {Params] are the optional 
parameters described in section Cl. 
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C-9. JUMP addr [params] 


The JUMP command "calls" the subroutine at the specified 
address ‘addr’. 'Addrt is evaluated as a hexadecimal number 
regardless of a following "H" 


character as in other commands. 
The JUMP command actually performs a "CALL" so that the called 


routine may return to the QCP. Examples of JUMP commands are 


JUMP 7000 <-- Jump to 7000H 
JUMP 7000H <-- Jump to 7000H 
JUMP O <-- Jump to QOOO0H 


JUMP <-- Jump to 0000H 
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c-10. LIST ufn 


The LIST command will print the specified file on the QP/M 
LST: (printer) device. Typing <CTRL+C> during listing will abort 
the command. Examples are 


LIST QPM.DOC 
LIST B:HELLO.C 
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C-11. REN ufnnew=ufnold 


The REN (rename) command will change the name of a file to 


new name; only unambiguous filenames are allowed. Rename takes 
the form 


REN ufnnewsufnold 


where ufnold is the old filename and ufnnew is the new name. 
Examples are 


REN PIP.COM=QPIP.COM <-- Rename QPIP.COM to PIP.COM 
REN QDOC=QDOC.BAK <-- Rename QDOC.BAK TO QDOC 


If ufnnew already exists, the message 


Delete File? 


will be displayed. Pressing any key other than a "y" or "Y¥" will 
abort the rename. 
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C-12. SAVE n ufn [option] 


The SAVE command copies 'n' pages (256-byte blocks) from the 
TPA (usually starting at 100H) into a file 'ufn'. 'N' is treated 
as a hexidecimal value if immediately followed by an "H", 
otherwise it is treated as a decimal value. The 'option' is the 
character "S" which specifies to copy 'n' SECTORS (128-byte 
blocks) rather than 'n' PAGES into the file. 


Assuming you wanted to save a file located from 100H to 
1000H, there are four ways to accomplish this 


SAVE 15 QPATCH.COM <-- Saves 15 decimal pages 

SAVE FH QPATCH.COM <-- Saves OF hexadecimal pages 

SAVE 30 QPATCH.COM S <-- Saves 30 decimal sectors 

SAVE 1EH QPATCH.COM S <-- Saves 1£ hexadecimal sectors 
If tufn' already exists, the message 

Delete File? 
will be displayed. Typing a "y" or "Y¥" will erase the current 
file on disk and replace it with the memory saved. Pressing any 
key otner thana "y" or "¥" will abort tne SAVE. 


If the SAVE command requires saving more memory than the 
specified disk space remaining, the message 


Full 


will appear and the SAVE will not occur. 
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H 
| 
C-13. TIME | 


The TIME command displays the current date and time (in 24- 
hour format) on the console device. Tne format is 


TIME 
at which the QCP returns 
dd-mmm-yy hh:mm:ss 
For example, QCP might return 
01-Nov-85 17:31:20 


If the QDOS has not been provided with a time-date vector, \ 
QCP will print 


No clock 


II-19 


QP/M Features and Facilities 
C-14. TOF 


The TOF command sends a top-of-form character to the QP/M 
LST: device. As distributed, this is the form-feed character 
(ASCII decimal 12), but can be changed via QINSTALL to be any 
user specified character. 
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C-15. TYPE ufn [option] 


The TYPE command will display the file on the console 
device. 'Option' is the character "P" which changes the default 
setting of tne PAGING flag. As distributed, PAGING is TRUE which 
means that the display will pause whenever the screen is filled 
during the TYPE command; display resumes when any key is pressed. 
The default value of the PAGING flag as well as the length of the 
screen can be changed with QINSTALL. Examples of TYPE commands 
are 


TYPE QNOTES.DOC <-- Lists QNOTES.DOC on the console, 
pausing whenever the screen is 
filled 

TYPE B:QNOTES.DOC P <-- Lists QNOTES.DOC from drive B on 


the console without pausing 


Note: Pressing <CTRL+C> while TYPE is displaying or pausing will 
abort the command. 
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USER 


[n] 


The USER command will change the currently active user 
'N' defaults to a decimal value but 


number to the value of 'n'. 


will be treated as a hexad2cimal value if immediately followed by 
it is assumed to be O (zero). The 


an "H". 


If 


nh! 


is omitted, 


USER number remains active 
boot, or QDOS function 32 is 


USER 
USER 
USER 
USER 


Valid user numbers 


1 
12 
ODH 


6a2 
nee 
Sam 
Cae 


tnt 


Sets 
Sets 
Sets 
Sets 


range 


until the next USER command, cold- 


executed. 


user 
user 
user 
user 


from 


number 
number 
number 
number 


to 
to 
to 
to 


Valid USER commands are 


1 decimal 
12 decimal 
13 decimal 
0 


0 to 15 decimal. 
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D. QP/M UTILITIES 


A description of all standard (and optional) QP/M utilities 
is presented in this section. Also ineluded is a procedure for 
patching the CP/M utility SUBMIT, so that it can be used with 


QP/M. (SUBMIT is not included with QP/M. Refer to original CP/M 
documentation for correct usage.) 


II-23 


_ 


I a er 


—o—ee 


QP/M Features and Facilities 


D (2k) 


D-1. D (2k) 


The D(irectory) utility functions similar to the DIR 
transient command, but includes much more information. The 2k 
version of D.COM is written at the "front" of your disk (just 
past the directory area) by the QSTAMP utility, for fastest 
operation. 


All files on the current or specified drive/user area are 
listed in alphanumeric order, and individual file sizes (in 
kBytes) are displayed. After the last file is displayed, D will 
count the directory entries, total the file sizes, show maximum 
disk capacity, and compute remaining disk space. 


Either the 2k or 4k version of D.COM will accept an "option" 
which consists of a "$" (dollar sign) followed by the option 
letter(s). The 2k "options" are: 


$T - Show file time/date information 

$L - List matcning contents of .LBR library files 
$R - Reset system before examining the directory 
$s - Show system files (files having SYS flag set) 


Examples of valid commands are: 


D $T <-- Display all files and show time/date info 

D Q.* $DL <-- Display all files of filename Q with 
time/date info and snow any matching .LBR 
directories 


D B:780.* $T $S <-- Display all files on drive 8 
of name 780.77? including SYStem files 
and show time/date information 


In actuality, the "options" toggle the related flags in the 
D.COM programs. Each option you enter changes the specific flag 
from FALSE [TRUE] to TRUE [FALSE]. Entering the same option 
twice as in 

D $DD 
D $S $S 


toggles the flag twice and hence has no effect. 


As delivered, both versions of D.COM have $S set to TRUE and 
all other option flags set to FALSE; thus, a directory listing 
will show system files but will not reset disk system, show 
time/date information, or list contents of .LBR files. QPATCH 
allows you to change the default settings of $S, $L, $R, or $T. 
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D-2. D (4k) 


The 4k version of D.COM (written by QSTAMPX) has all of the 
same features of the 2k version, plus these new capabilities: 


(1) Seareh for files created, updated or backed-up on, 
before, after, or between specific dates. 

} ' 

) Search all drives. 

) Search for all files that have not been backed up. 


nnn 
Fw Pp 


Search all user areas. 


All 4k D.COM options are listed below. (The 2k options, $T, $L,; 
$R, $S, are toggled; the unique 4k options must be entered every . 


time you wish to use them.) 


$T - Show file time/date information 

$L - List contents of .LBR library files 

$R - Reset system before examining the directory 
$S - Show system files (files having SYS flag set) 
$A - Search all user areas 

$D - Search all logged drives 

$B - Use "backup" date instead of "updated" date 
$N - Show files that have not been backed up 

$C - Use "created" date instead of "updated" date 
$U - Use "updated" date (default) 


The format of the 4k D.COM command line is: 
D ([du:filename.ext] [$option(s)] [begin d/t]l;end d/t] 
where du:filename.ext is a file specifier (with drive, user 
and extent optional) 
$option(s) are one or more options 
begin d/t is the beginning date/time range 
end d/t is the ending date/time range 


The command line must have the parameters in the above order 


(i.e. $option(s) MUST occur before dates). All parameters are 
optional. 


Date searches are done as follows: 
[begin date/time][;end date/time] 


The format of 'begin date/time! and tend date/time' is as 
follows: 


m/d/y [him] 


The time is optional and is set to 00:00 if omitted in ‘begin 
date/time'; if omitted in ‘send date/time', 23:59 is used. 
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(continued) 


If "begin date' is omitted, a date of 00/00/00 is used, and 
time defaults to 00:00. If ';end date' is omitted, a date of 
99/99/99 and time of 23:59 is used. Search ranges are inclusive 
of the date(s) and time(s) referenced. 


Examples of valid commands are: 


D $T$N <-- Display all files that have not been 
backed up, showing time/date info 


D Q*.* 2/1/85 <-- Display all files which start with "Q", 
that were updated on or after 2/1/85. 


D B:#.* $TN $C 33/1/85 <-- Display all files on drive B 
that were created on or before 3/1/85, 
and have not been backed up. Also 
show time/date created. 


D *.* $DA 7/1/85 08:00;7/1/85 12:00 <-- Display all 
files in the current user area and 
logged drive which were updated 
between 8 A.M. and noon on 7/1/85. 


II-26 


QP/M Features and Facilities 


INIT 


INIT (Included with QBIOS package only) 


The INIT(ialize) utility is used to 


make a "blank" or 
unformatted disk compatible with your systen. You must specify 
which drive is being initialized (A-P). The INIT command also 
works to effectively erase all data on existing formatted disks, 
so use caution not to INIT unless you are sure. 


You will be asked for the PHYSICAL drive to be initialized, 
regardless of logical drive assignment, 


so again use extra care. 
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D-H. QBACKUP 


QBACKUP is used to make a backup (identical copy) of an 
entire disk, or to copy only those files which have been updated 
since the last time QBACKUP was used. The latter feature is 
especially useful when you have a full disk of files to backup, 
yet only a few have been updated. 


Both source and destination disks must be properly time/date 
stamped for QBACKUP to work (see QSTAMP). 


You will be given the option to delete "old" files that 
exist on the backup disk, but not on the source disk. This is 
recommended when you have a dedicated backup disk for a specific 
source disk, as you no longer have to compare directories side- 
by-side to weed out the files previously deleted from the source. 


QBACKUP will transfer files sequentially, starting at the 
beginning of the sorted directory (as you would see when running 
D.COM). During transfer, if there is inadequate space to write a 
new file to the destination disk, QBACKUP will give an error 
message and return to the beginning of the program. You can then 
use a new backup disk to finish the process, or exit QBACKUP and 
delete unwanted files from the original backup disk. 


QBACKUP transfers files safely in a similar manner to QPIP 
(the "old" File is not deleted from the destination disk until 
the "new" file is written and verified). This means that there 
must be adequate space on the backup disk to hold the source 
files, PLUS enough free space equal to the largest file that 
: :quires transfer. As an example, assume that three files 
require transfer as follows: 


Filename Size 
CALCDATA.001 15k 
PROPOSAL 32k 
D ~COM 4k 


If these are all old files whose sizes didn't change, the 
destination disk would require 83k free space: 15+32+4 PLUS 32 
(largest file to transfer). If less than 83k is available, 
QBACKUP will print the message like: 


Tnere is not enough room on destination drive for backup. 
83k is required, but only 5k is available. 


Do you want QBACKUP to delete the (old) destination file 
BEFORE transferring the (new) source file? (Y/N): 
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(continued) 


This will cause QBACKUP to delete the current destination 
file FIRST (thereby making more space available), then 
transferring the updated file from the source. QBACKUP leaves 
the choice to you, as there is a risk (though minimal) should the 
source file not transfer successfully. 


As a second example, 
were all new. 
(1543244), 


assume that the three files listed above 
disk. 


QBACKUP would only require that 51k was free 
as there would be no "old" files on the destination 


a 
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QINSTALL is used for either first-time installation of QP/M 
or modifying the QCP and QDOS default parameters. Refer to part 
I, QP/M Installation Guide, for further details. 
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QPATCH 


QPATCH is used to modify tne default settings of D.COM 
(either the 2k or 4k versions), and QBACKUP.COM. This utility is 
entirely self-prompting. 
Experienced users who wish to change the "Restore default 
settings" values of QPATCH should refer to section B of the QP/M 
Supplement. 
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ReFs QPIP 


QPIP is the Peripheral Interchange Program for QP/M users. 
While QPIP is fully compatible with all CP/M PIP options (plus a 
few new ones), QPIP will ONLY work with disks that were 
time/date stamped by QP/M. 


QPIP allows you to copy single files, or concatenate 
(combine) several files into one. QPIP also lets you specify the 
device names (TTY:, CRT:, PTR:, etc.) to which the files should 
be copied (or printed). 


QPIP can be entered as a command by itself, or may contain 
it's own parameters: 


A>QPIP 
A>QPIP HAPPY=SAD 


When entered as inthe first example, QPIP gives a prompt of 
wet, and will execute subsequent commands read from the console, 
until a <CTRL+C> or empty line <RETURN> is encountered. In the 
second example, QP/M ‘toads the QPIP program, then reads the 
parameters directly from the console (no further prompting is 
given). Wnen QPIP finishes, it returns you to QP/M. 


In all QPIP commands, the destination is entered first, then 
an "equal" sign (=), followed by the source(s). The following 
rules also apply: 


A drive designator is permitted on either the source and/or 
each destination (default is current drive) 


A>QPIP A:QSTAMP.NEW=B: QSTAMP.NEW 
In addition, QPIP allows you to specify the user area that 
should be read from/copied to (default is current user area): 
B>QPIP B2:D.COM=A0:D.COM 
Multiple source files may be used to combine several files 
into one destination file, but each source file must be separated 
by commas (,). In addition, these files should be ASCII files as 
QPIP ends the transfer upon reading an EOF character (ASCII 


decimal value of 26). 


B>QPIP BIG1=SMALL1,SMALL2,SMALL3 
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(continued) 


If either the destination or source filename is omitted, 
QPIP will use the one filename for both read and write; the 
examples below produce identical results : 


B2>QPIP B:=A:QINSTALL.COM 
B2>QPIP B:QINSTALL.COM=A: 


QPIP will always copy actual file dates (update and create), 
but will not set the archive bit (see QSTAT). If you desire to 
use the current time/date instead, specify the transfer command 
with a [C] option. If you want the transferred files to carry a 
time and date other than the original or current values, you will 
have to first transfer the files, then use QSTAT with an option 
of [$CRE], ([$UPD], or [$BAK]. 


Wild cards (see 2k D.COM documentation) may be used to 
specify groups of files; each file transferred will be listed 
sequentially on the console 

A1>QPIP A:=B:Q¥*.COM 
Physical or logical device names (see QSTAT) may be used 


A>QPIP LST: =sSOURCE1 


B>QPIP DUMP7=UR1: 


QPIP also has some special device names 


INP: This is a special QPIP input source that gets data one 
character at a time, by repetitive CALLs to 103H; data 
is returned at 109H *# 


OUT: This is a special QPIP destination that CALLs location 
106H with the data in register C, to transmit one 
character at atime #** 


PRN: This is identical to LST:, except that tabds are 
expanded at every eighth character position, lines will 
be numbered, and an initial page eject is sent before 
transmission begins, and every sixty lines thereafter 


** The QPIP program must be patched for this function 
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QPIP performs a special function when writing to a .HEX file 
from an external peripheral device. When reading from a properly 
formed hex file and an error occurs, QPIP will give an error 
message. The program halts while the peripheral device is 
"backed up". A <RETURN> will tell QPIP to re-read that same 
section again, or continue from that point forward. If the 
source device is RDR:, QPIP will allow you to type <CTRL+Z> to 
signify end-of-file. 


QPIP has several optional parameters which can be specified 
at the end of the command line by enclosing the option in 
[brackets]. These parameters are: 


B Block mode transfer: Buffer all input data until a 
<CTRL+S> (ASCII X-OFF character) is received from 
the source device. This allows continuous reading 
from tape, for example. After the X-OFF is 
received, QPIP clears the buffer and returns for 
more input data. An error message will tell of 
buffer overflow. 


Cc Use current time/date when transferring files. 

Dn Delete characters extending past column n. 

E Echo all transfers to the console. 

F Filter (remove) all imbedded form feeds from the 
file. P can be used simultaneously to insert new 
form feeds. 

Gna Get file from User number n (QPIrF will do this 
automatically if the drive and user number are 
specified in the command line) 


H Hex data transfer (see above) 


I Ignore ":00" records while transferring an Intel 
file. I sets H parameter automatically. 


L Translate all upper case characters to lower case. 
N Add line numbers, starting at "1:3". Leading 
zeroes are supressed, unless "N2" is specified. 


N2 also inserts a tab after the number, and the 
tab is expanded if the T option is also used. 
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Object (non-ASCII) file transfer. Ignore normal 
QP/M end of file. 


Add page ejects, starting at the front of the 
file, and every n lines thereafter. Default is 
every 60 lines. If F is also used, form feed 
suppression precedes the page ejects. 


Quit copying from source when string s found. 
(string terminated by a <CTRL+Z>) 


Read system files 


Start copying from source when string s found. 
(string terminated by <CTRL+Z>) 


Extend tabs <CTRL+I> to every nth column during 
transfer. 


Translate lower case to upper case. 
Verify correct transfer by rereading a disk file 
immediately after it is written. NOTE: Verify is 


ALWAYS done by QPIP when transferring disk files. 


Write over R/O files without prompting for Y/N 
(see example below). 


Zero the parity bit on input for each ASCII 
character. 


Unless the [W] option is used, whenever QPIP is asked to 
write over a R/O file, the user will be asked for confirmation in 


this format: 


File QINSTALL.COM R/O, Delete? (Y/N): 


Responding with a "Y" will overwrite the old file with the 
new data. Otherwise, QPIP returns a response of: 


## NOT DELETED ** 
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QSTAMP/QSTAMPX are the QP/M disk time/date stamping 
utilities. Since time/date stamping is independent of the system 
tracks, they can be blank, or contain a CP/M or QP/M systen. 
However, before time/date stamping will, occur, you MUST run 
QSTAMP to place all necessary time/date parameters on each disk. 


Two things must be present before QP/M will time/date stamp 
a disk: 


(1) QP/M must be the running system 


(2) The disk itself must be time/date capable (QSTAMP 
must have already been completed on this disk) 


Running QSTAMP on a disk with CP/M system tracks WILL make a 
disk time/date capable, but your system MUST be running under 
QP/M, as CP/M alone CANNOT update the time/date information. 
This also means that if you "Swap" disks, then do a warm boot 
<CTRL+C>, the disk that you warm-booted MUST have QP/M system 
tracks. 


QSTAMP will automatically reset the referenced drive before 
attempting to time/date stamp. This is useful when you have 
multiple disks to stamp. Note that QP/M uses the CURRENT 
time/date when initially stamping a disk. 


QSTAMP also automatically writes a D.COM (2k directory 
utility) file to the very first file sectors on the disk. This 
ensures fastest access to the directory. The (optional) QSTAMPX 
utility writes the expanded (4k) D.COM file. 


If an attempt is made to time/date stamp a disk that has 
already been made time/date capable, QSTAMP will display a 
message to that effect and no stamping will be done. This 
prevents accidental destruction of existing time/date 
information. 


If you wish to install your own directory program, refer to 
Section B of the QP/M Supplement. 
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D-9. QSTAT 


QSTAT has three main functions: examine general statistical 
information about a file; alter file status and time/date 
information; and examine/alter the current physical-to-logical 
device assignments. QSTAT, like QPIP, will only work with QP/M. 


To examine the specifications of a file, enter; 
A>QSTAT QPATCH.COM 


If a file match is found, QSTAT will display the 
specifications of the file in the following format: 


Recs Bytes Ext Ace Bak du:filename 
25 4k 1 R/O Yes- AO: (QPATCH.COM) 
Recs shows the number of 128-byte records 
Bytes shows the number of kilobytes allocated 
Ext shows the number of directory extensions 
Ace shows R/O or R/W access mode 


Bak shows whether file has been backed up 
Files in ( ) designate SYS files 


A single $ option ($T) may be entered to display time/date 
information as well: 
ADQSTAT QPATCH.COM $T 
If a match is found, QSTAT will display: 


Recs Bytes Ext Acc Bak du:filename 
Created Updated Backup 


25 12k 1 R/O A1l:QPATCH.COM 
01-Feb-85 12:00 02-Feb-85 11:45 O02-Feb-85 16:15 
QSTAT will also accept a $S option (with or without $T) to 
show virtual size: 


B>QSTAT D.COM $S 


Size Recs Bytes Ext Acc Bak du:Filename 
16 16 4k 1 R/O Yes A2:D.COM 
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As a special case, QSTAT may be entered as a command by itself: 


A>QSTAT 


This will cause QSTAT to calculate the available storage on 
all active drives and print a status as follows: 


Drive A is R/O, with 18k space remaining. 
Drive B is R/W, with 490k space remaining. 


Drive and user number may be used to status a file on any 
drive, in any user area, regardless of current or default 
drive/user area: 


A5>QSTAT B1:QPIP.COM 


Wild cards can be used on the command line to specify 
ambiguous file names, such as: 


B>QSTAT *.* (run QSTAT for all files on current drive rw) 
and current user area) 


ADQSTAT B3:Q*.COM (QSTAT all files on B3:) 
A drive may be set to R/O (read only) or R/W (read/write) by 
entering: 
A>QSTAT B:=R/0 
A3>QSTAT Az=R/W 
QSTAT will give a message such as: 
Drive B is now R/O. 

The first example will set drive B: to R/O. The second 
example will set drive A: to R/W (effectively resetting it). 
Note that you cannot set individual user areas to R/O or R/W, 
only the entire drive. A drive set to R/O will remain R/O until 
the next warm or cold start, or drive reset is performed. If an 
attempt is made to write to a drive that is set R/O, QP/M will 


return the error message: 


QDOS error on Bs: R/O oO 
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Individual files may be set to R/O or R/W (read/write), SYS 
or DIR (non-sys) using the "$" options listed below: 


$R/O (make file read/only) 
$R/W' (make file read/write) 
$SYS (make file SYS) 

$DIR (make file non-SYS) 


NOTE: Multiple $xxx options can be used if they are 
separated by single spaces. If two options on 
the QSTAT command line conflict, QSTAT will only 
use the latter of the two. 


If QP/M tries to write to a file that is marked R/O, an 
error message will be returned, such as: 


QDOS error on B: File R/O 


QSTAT also premits you to display QP/M-unique parameters: 


$CRE (change create date/time) 
$UPD (change update date/time) 
$BAK (change backup date/time) 


The format for all time/date changes is as follows: 


$CRE=mm/dd/yy hh:om 


A check is made for month range 1-12, day range 1-31, year 
range 00-99, hours 0-23, and minutes 0-59. 


As an example of the preceding paragraphs, you coula enter: 


A>QSTAT QBACKUP.COM $UPD=2/1/85 12:00 


This would change the update date of QBACKUP.COM to 01-Feb- 
85 12:00. 


The backup status (archive bit) can be set or reset as 
follows: 


A>QSTAT D.COM $NEW 
BOQSTAT D.COM $0OLD 


The $OLD option tells QP/M to set the file to "backup" 
status (i.e., treat as if QBACKUP has already been done). $NEW 
resets the archive bit as if the file is "new" and has never been 
backed up with QBACKUP. 
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QSTAT allows you to change the physical-to-logical device 
assignment. The four logical devices are: 


CON: Console device 


RDR: Paper tape reader 
PUN: Paper tape punch 


LST: Output list device 


These logical devices may be assigned to any of four physical 
devices as listed below: 


Logical Physical 


CON: TTY: Teletype device (slow speed console) 
CRT: High speed console 
BAT: Batch processing (console is current RDR:, and all 
output goes to current LST: device) 
UC1: User-defined console 


RDR: TTY: Teletype device (slow speed console) 
PTR: Paper tape (high speed) reader 
UR1: User-defined reader #1 
UR2: User-defined reader #2 


PUN: TTY: Teletype device (slow speed console) 
PTP: Paper tape punch (high speed punch) 
UP1: User-defined punch #1 
UP2:; User-defined punch #2 


LST: TTY: Teletype device (slow speed console) 
CRT: High speed console 


LPT: Line printer 
UL1: User-defined list device #1 


To view the current physical device assignments, type: 
BO>QSTAT DEV: 

Which might return: 
CON: is CRT: 
RDR: is UR1: 


PUN: is PTP: 
LST: is TTY: 
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To view the possible assignments which can be made, or to 
view the various QSTAT commands available, type: 


A>QSTAT 


VAL: 


Which will return: 


Temp R/O 
Temp R/W 


Disk: d:=R/0 
Disk: d:=R/W 


Set indicators: du:name.typ $R/O $R/W $SYS $DIR $OLD $NEW 
Change time/date: duz:name.typ $CRE=mm/dd/yy hh:mm 


User status: 
Disk status: 


$UPD=... $BAK=... 


IObyte assignment: 


CON: 
RDR: 
PUN: 
LST: 


To change an 
 #] A>QSTAT 
To check the 


A>QSTAT 


USR: 
DSK: 
ITY CRT: BAT: UCI: 
TTY: PTR: UR1: UR2: 
TI Ye PTP: UP1: UP2: 
TTY: CRT: LPTs: UL13: 


assignment, you would type: 
logical device:=physical device: 
status of all logged-in drives, you would type: 


DSK: 


This would return the drive characteristics in this format: 


As 
5392: 
674: 
128: 
128: 
128: 
163 
T2: 
2: 


Drive Characteristics 
128-byte Record Capacity 
Kilobyte Drive Capacity 
32-byte Directory Entries 
Checked Directory Entries 
Records/ Extent 

Records/ Block 

Sectors/ Track 

Reserved Tracks 


To check active user areas: (those which contain files), you 


would type: 


B>QSTAT 


USR: 


This would produce a display similar to: 


*] Active User: 0 


Active Files: 0 1 31 
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QSUB is the QP/M utility used to execute a batch program. A 
batch program allows the computer to process commands and operate 
as if the user were entering commands from the console (usually a 
keyboard). 

The QSUB batch utility consists of commands, one per line, 
which are executed sequentially, as if typed at the keyboard. 
All of the QCP transient commands are available (e.g. DIR, TYPE, 
etc.) as well as a number of special QSUB commands. Once the 
QSUB utility has been invoked, it assumes control of the system 
until the batch program is completed or an abort occurs. 

Unlike the CP/M SUBMIT utility, QSUB loads itself into 
memory directly below the QCP. If any other utility currently 
occupies this space, QSUB will print a message and abort. Since 
it is memory-resident, applications programs running under QSUB 
will have approximately 5k (5120 bytes) less execution space. 
However, the speed increase gained by having batch commands 
resident in memory versus reading them from disk is well worth 
the tradeoff. 


The format of the QSUB command is 
d>QSUB <QSUB file> param#l param#2 ... <return> 


where 
<QSUB file> is a special command file with an extension 
of ".QsB" 
param#l, etc. are optional parameters entered on the 
command line. 


Parameters entered on the command line are passed to QSUB as 
internal "variables" designated @1, @2, etc., up through @8. 
These variables correspond to the matching param# (i.e. @2 is set 
to the value of param#2). If the parameter is missing from the 
command line, QSUB sets the variable to a "null" value (@i = ""). 
There are two command line restrictions: (l) the length of any 
parameter cannot exceed 16 characters and (2) only 8 parameters 
maximum are allowed. 


GENERAL COMMANDS 

QSUB commands can be any commands which are normally entered 
from the keyboard. QSUB retains control of the console input at 
all times, although keyboard characters are processed within the 
@GET, @PAUSE, and @XSUBO functions. In addition to the normal 
QCP transient commands (which are allowed in QSUB), QSUB offers a 
number of powerful commands to assist the programmer. All 
special QSUB commands are preceded by the "at" sign (@) which 
usually occurs at the beginning of a line. 
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QSUB operates by fetching a character from the QSUB file 
whenever one is requested by the system. However, all console 
status checks test the actual console. .In this case, if a 
character is entered via the keyboard, it will be the next 
character which the system will receive. (A good example of this 
is when the D.COM utility pauses after the screen is full; since 
D.cCOM is checking the console status, the system will wait for a 
keyboard character even if a QSUB utility is active. After 
pressing any key, QSUB resumes control of the system.) 


NESTING 


QSUB programs may call other QSUB utilities, up to a level 
of 8 deep. All variables and settings within QSUB are restored 
to their previous values upon return from another QSUB utility. 
Although variables are initialized upon entry into another QSUB 
utility, the previous display setting (show/hide) remains intact. 


VARIABLES 


There are 16 variables in QSUB: @1..@8 and @V1..@V8. The 
variables @1 through @8 are set from the command line of QSUB 
upon execution, whether activated from tne console or from 
another QSUB program. The remaining user variables, defined as 
@Vl through @V8, are initialized to null strings ("") upon 
execution of QSUB. NOTE: The variables are ALWAYS initialized 
upon entry into a QSUB program, regardless of whether QSUB was 
executed from the console or another QSUB program. When a QSUB 
batch program invokes another QSUB program, all variables are 
saved on a disk file and later recovered before the calling QSUB 
batch program resumes. 


As an example, here are two QSUB programs, one of which is 
called by the other: 


TEST.QSB TEST1.QSB 

@LET @V2 = "Sample 1" @LET @V2 = "No sample" 
QSUB TESTIL DIR 

@LET @Vl = @v2 @EXIT 


@V2 is set in TEST followed by control being transfered to TESTI. 
Upon entering TEST1, @V¥2 becomes a null string; the first 
statement changes @V2 to another value. When TESTI completes, 
control is returned to TEST restoring the previous values of all 


variables. Consequently, the final statement of TEST will set 
@Vl to "Sample lL". 
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A variable consists of an ASCII string which contains a 
maximum of 16 characters. Longer strings may be used as long as 
the maximum string area is not exceeded and with the 
understanding that a long string precludes use of succeeding 
variables. To help in understanding this, a memory map of 
variable storage is shown below: 


Variable Relative Start Location 
@l 0 
@2 16 
@3 32 
@4 48 
@5 64 
@6 80 
@7 96 
@8 112 
@v1 128 
@v2 144 
@v3 160 
@v4 176 
@V5 192 
@v6 208 
@v7 224 
@v8 240 
<End of string space> 256 
For example, if @2 = "This is a 30 byte long string.", then the 


@3 variable would be rendered useless even though there are still 
2 bytes free. 


SUBSTITUTION 


In non-QSUB commands, each variable encountered is 
substituted by its ASCII string. For example, if @4 = 
"PROG.BAS", then 

MBASIC @4 
will actually execute 

MBASIC PROG.BAS. 

Only variables are substituted. If you need to use two strings 
as one substitution parameter, you must first set a free variable 
to the strings, then use that variable. For example, let's 
assume you really wanted to use drive C to get the file PROG.BAS. 

MBASIC C:@4 
is valid. However, you could have also used 

@LET @V8 = "C:" & @4 

MBASIC @V8 
to achieve the same result. The latter is more powerful for 
applications that require it. 
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PRIMARY COMMANDS 


‘ 


Included here is a list of commands which are immediately 
executed and have no effect on the value of the variables. 


@! s Displays the string s on the console. A string 
can be either a simple string or a complex string. 
A simple string is either 
- a variable (@1 .. @8, @V1l .. @V8) 
- a sequence of ASCII characters surrounded by 
either single (') or double (™) quotes. 
- a constant. QSUB has four constants which it 
recognizes: 
@?U0 returns a two character string equal 
to the current user (e.g. "00" through "31"). 
@?DU returns a two character string equal 
to the current default user (e.g. "00" 
through "14"). A null string is returned if 
default user search is disabled. 
@?D returns a single character equal to 
the current drive (e.g. "A" through "P"). 
@?DD returns a singte character equal 
the current default drive (e.g. "A" through 
"O"). A null string is returned if default 


drive search is disabled. 


to 


A complex string is two or more simple strings 
which are concantenated together with an ampersand 
(&). The string s may contain two special 
characters which QSUB recognizes: %Z and /, neither 
of which are displayed. When QSUB encounters a % 
in a string, it sends 30 return-line feeds to the 
console output simulating a clear screen command. 
A / is treated as a single return-line feed. Note 
that the @! does not automatically add a return- 
line feed sequence to the end of each line; the 
user must do it explicitly. 


For example, let @V4 = ":CALEN.COM", user be 3, 
and default drive be "A". The commands 


@! "%Good morning! (Current user " & @U & ")" 


@! '/File is ' & @DD & @V4 


would cause QSUB to send 30 return-line feeds, 


and print 
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Good morning! (Current user 03) 
File is A:CALEN.COM 


The characters Z and / are only treated specially 
in @! and @GET. 


Causes immediate termination of the QSUB utility. 
Regardless of how many levels of QSUB are active, 
@ABORT will return control of the operating system 
to the user. 


If the current QSUB program was executed from 
another QSUB program, @EXIT returns control to the 
calling QSUB. If not, @EXIT returns control of 
the operating system to the user. 


NOTE: QSUB will automatically execute a @EXIT 
after the last statement of the currently running 
QSUB program has been completed. 


Prints the message 


"Press any key to continue (CTRL+C to abort) --- " 


and waits for a console character. The character 
CTRL+C (03H) will immediately terminate the QSUB 
utility through the @ABORT command. Other 
characters will be discarded and QSUB execution 
resumed. 


Disables the console output device, "hiding" all 
console output. This is useful for executing 
programs where you do not want to display the 
activity. This command stays in effect until the 
execution of a @DISP1, @EXIT, or @ABORT. 


Enables the console output device. This has the 
opposite effect of the above command. 


With the exception of @PAUSE and @GET, QSUB 
normally fetches all characters from the batch 
file. @XSUBO disables this feature (i.e. 
characters are fetched from the console) until a 
warm boot occurs directly via "“C" (CTRL+tC) or 
indirectly via program termination. 


This special sequence is used if the "at" sign is 


required by an applications program. Whenever two 
“at" signs appear together, it is passed to the 
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executing program as a single "at" sign and no 


QSUB command check is made. 


LABELS and JUMPS 


@: label Defines a label for use within the current QSUB /; 
batch file. Label is a string from 1 to 16 | 
characters; the two restrictions are that each j} 
character must be either an alphabetic or numeric |! 
character (A-Z, 0-9) and that a label must occur | 
on a line by itself within the current QSUB } 
utility. pee \ 


@GOTO label Transfers control of the QSUB to the matching \ 
label described above. If label is not found, \ 
QSUB will print a message and abort. \ 


CONDITIONALS \ 


@IF(cs) cmd If the conditional statement cs is found to be 
TRUE, QSUB will execute the command cmd. If not, \ 
QSUB will resume execution with the next line in 
the batch file. Cmd iis any group of characters 
which will be processed by the current program or 
it may be a QSUB command. Cs is a conditional 
statement of the following form 

<simple string><conditional><simple string> 

where 


ASCII characters surrounded by either single- or 
double-quotes. 
<conditional> is any one of the six 


t 
1 
| 
| 
<simple string> is any variable or a group of | 
| 
conditionals: | 


< less than 

<= less than or equal to 

> greater than 

>= greater than or equal to 
= equal to 

<> not equal to 


Since QSUB does not perform any case conversion 
("a" to "A", for example), it is recommended that 
all filenames be in upper case when used in 
conditional statements. 
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Looks for the file specified by the string s. 
String s may be either a simple or complex string 
as described in @! and is of the form 
"diname.ext™ with drive and extension optional. 
If the file is found, the command cmd will be 
executed; if not, QSUB will resume execution on 
the next line. 


MODIFYING VARIABLES 


@LET 


@GET(s) <var> 


EXAMPLE 


@LET is used to change the value of any variable 
to another value. The statement is always of the 
form 

@LET <var> = <string> 
where 

<string> can be either a simple or complex 
string as described in @!. 


Prints the string s at the terminal and waits 
for user input from the console. After the user 
has entered a valid 16 character or less string, 
QSUB sets the value of <var>, which is any of the 
16 variables, to the string entered. This is the 
alternative to the @LET statement as it allows the 
user to change the value of a variable during 
execution. QSUB treats the two special characters 
(% and /) in s the same as it does in @!. 


The following simple example demonstrates some of QSUBs 


capabilities: 
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@! "% File Copy Utility//" 
@:TOP 


@GET("/Enter the source filename (d: 


@IF(@VL = "") @EXIT 
@FIL?(@V1) @GOTO OKFIL 


name.ext): ") @V1 


@! "File " & @V1 & " does not exist./" 

@GOTO TOP 

@:OKFIL 

@GET("/Enter the destination filename (d:name.ext): ") @v2 
@FIL?(@V2) @GOTO EXISTS 

@: COPY 

QPIP @V2=@V1 

@GOTO TOP 

@: EXISTS 

@! "Destination " & @V2 & " exists./" 

@GET(" Overwrite destination file? (Y/N): ") @3 
@IF(@3 <> "Y'") @GOTO TOP 

ERA @V2 

@GOTO COPY 


Let's assume that the user wishes to move WS.COM on drive C to 


drive A and EXAMPLE.TXT from drive D 


to drive C renamed to 


EXAMPLE. EXAMPLE already exists on drive C. Comments are shown 


with <-- on the right hand side. 


d>QSUB COPY 
File Copy Utility 


Enter the source filename (d:name.ext): 


C:WD.COM <-- misspelled 


File C:WD.COM does not exist. ; <-- Whoops! Try again 


Enter the source filename (d:name.ext): 


C:WS.COM <-- Source name 


Enter the destination filname (d:name.ext): A:WS.COM 


QPIP A:WS.COM=C:WS.COM <-- First copy 


being done 


Enter the source filename (d:name.ext): D:EXAMPLE.TXT 


-- User enters name 


Enter the destination filname (d:name.ext): C:EXAMPLE.TXT 


Destination C:EXAMPLE.TXT exists. 

Overwrite destination file? (Y/N): Y <-- 
ERA C:EXAMPLE.TXT Cm 
QPIP C:EXAMPLE.TXT=D: EXAMPLE.TXT <-- 


Enter the source filename (d:name.ext): 


‘Esa 


<-- Message 

User still wants to copy 
Erase destination file 
Do the copy 


<-- Return by itself 
exits COPY 
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D-11. SETxx (Included with QBIOS package only) 


The SETxx program is executed on cold-boot to set the date 
and time. (QBIOS modules are written so that the autoboot 
command is still available.) This program will ask you for the 
date and time (in 24-hour format) before allowing you to proceed 
into QP/M. If you use a software clock, it is IMPERATIVE that 
this program be the first one that is executed. Otherwise, the 
time/date information that QP/M uses will not be correct. 


You will be asked to set the date and time as shown: 


(24-hour format) 
Enter DATE and TIME: mm/dd/yy hh:mm:ss Display? (Y/N/R) 


Type <Y> to display the time in the top right-hand corner of 
your screen. <N> will supress the display. <R> allows you to 
re-enter the date and time. 


“SETxx will ecneck for the following values: 


nn between 01-12 
dd between 01-31 
yy between 00-99 


hh between 00-23 
oo between 00-59 
ss between 00-59 


SETxx will check for valid dates (e.g. only 30 days in 


September), except for February 29, which can be entered for any 
year. 
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D-ie. SYSGEN 


The SYSGEN.COM utility allows you to make an initialized 
disk "bootable" by writing QP/M to the system tracks. You will 
first be prompted to load QP/M into memory by reading the system 
tracks from an existing bootable disk. Once the QP/M system 
image is in memory, you can write system tracks to one or more 


disks in succession. 
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SUBMIT.COM must be patched to run with QP/M by the 
following procedure. This patch simply forces SUBMIT to always 
place the $$$.SUB file on Drive A:. The brief instructions 
below will show you how to do the patch. 


AD>DDT B:SUBMIT.COM <-- Tell DDT to load the SUBMIT program 
DDT VERS 2.0 (in this case, from drive B:) 

NEXT PC 

0600 0100 

-S5BB <-- Enter "SSBB" and press <RETURN> 

O5BB 00 1 <-- Enter "1" and press <RETURN> 

ospc 24. <-- Enter <PERIOD> and press <RETURN> 

-"C <-- Press <CTRL+C> to exit DDT 


A>SAVE 5 NEWSUBMT.COM <-- Save new SUBMIT.COM file 
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Ta QP/M SEARCH CAPABILITY 


The first and most basic thing to learn about QP/M is the 
order in which it searches for acCOM file for execution of a file 
when a system call is made to Function 15 Open File. Under the 
CP/M 2.2 CCP, if the specified COM file command was not found 
on the current drive in the current user area, the CCP aborted 
with an error message. QP/M continues searching from this 
point a maximum of two more levels. This command hierarcny 
search was outlined in Section A, and is described here in 
further detail. (The search within Function 15 is deseribed in 
part III.) 


a. CHECK TRANSIENT COMMAND LIST 


If the command is of the form 'COMMAND! and NOT 
"dsCOMMAND', the QCP-resident (transient) command list is 
searched for a match. If a match is found, the transient 
command is immediately processed. If a match is not found, 
QP/M continues to the next step. 


(Note that the 'd:COMMAND' form is good for executing a 
command 'COM' file which has the same name as a transient 
command such as SAVE.COM or DIR.COM.) 


b. CHECK CURRENT DRIVE/CURRENT USER AREA 


The current drive and current user area is scanned for 
COMMAND.COM. If found, the command is loaded into memory 
starting at 100H.If not found, QDOS continues. 


c. CHECK CURRENT DRIVE/COMMON USER AREA 


If Default User Search has been disabled, QDOS skips to 
step d. Otherwise, a check is made to see if the current 
user number matches the default user number. If they are 
different, QDOS searches the directory of the default user 
area. If COMMAND.COM is found, it is loaded as described 


above and executed. If not found, QDOS proceeds to the next 
step. 


(Default User number may be initially set on cold boot, 


entered manually via the DFU command, or changed by Function 
42, Get/Set DFU.) 
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d. CHECK COMMON DRIVE/COMMON USER AREA 


QDOS has now determined that COMMAND.COM cannot be 
accessed from the current drive, nor the common or current 
user areas. If default drive search is disabled, QDOS ends 
the search. Otherwise, QDOS checks to see if the current 
drive is equal to the default drive. If not, QDOS 
temporarily logs into the Default Drive and searches the 
Default User Area for COMMAND.COM. If found, it is loaded 
as described above and executed. If the file is not found 
or default drive search has been disabled, QCP prints the 
command name as an error message (COMMAND?) and returns to 
command input mode, aborting the SUBMIT file or QSUB if 
COMMAND came from it. 


In all cases of the search above, if and when COMMAND.COM is 
found and loaded into memory, QDOS returns to the original disk 
drive and user number. 


To illustrate this command hierarchy search, consider the 
following examples: 


Example i: Default User is 0, Default Drive is A 


B10> <-- User is on Drive B:, User Number 10 
B10>ASM TEST.BBZ <-- User wishes to assemble TEST.BBZ in 
Drive B:, User 10 
<-- At this point, QDOS looks on B:/10 for ASM.COM, fails, 
looks on B:/0, fails, and finally looks on A:/0; it 
finds ASM.COM here and goes back to B:/10 for the file 
TEST .BBZ 


Example 2: Default User is 0, Default Drive is A 


B10> <-- User is on Drive B:, User Number 10 
B1O0>DFU 5 <-- User Selects User 5 as default 
B10>ASM TEST.BBZ <-- As above 


<-- At this point, QDOS looks on B:/10 for ASM.COM, fails, 
looks on B:/5, fails, and finally looks on A:/5; it 
fails here also and prints ASM? as an error message 
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B10> ¥-- User is on Drive B:, User Number 10 
B10>DFU 5 <-- User Selects User 5 as default | 
B10>DFD B: <-- User Selects Drive B as default | 
B10>ASM TEST.BBZ <-- AS above 
<-- At this point, QDOS looks on B:/10 for ASM.COM, fails,; 
look. on B:/5, fails and prints ASM? as an error ! 
message 


Example 4: Default User is 0, Default drive is A 


B1i0> <-- User is on Drive B:, User Number 10 \ 
B1IO>DFU 15 <-- User Disables user search capability \ 
B10>ASM TEST.AAZ <-- AS above \ 


<-- At this point, QDOS looks on B:/10 for ASM.COM, fails, 
looks on A:/10, fails, and prints error message of 
ASM? 
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QCP COMMAND SUPPORT 


a 


QCP operates at ZCPR Command Level 3. This command 
level allows the current program in memory to place a 
command line into QCP. Once control is given to QCP, the 
current program releases control and the command is executed 
exactly as though it had been typed by the user at his 
console terminal. ‘ 


In order for a program in memory to utilize the Command 
Level 3 facility, the program MUST do the following: 


A. Locate the QCP. Since the QCP is ALWAYS 2K bytes in 
size and located directly under QDOS, the program can locate 
the QCP by examining the QDOS entry page address at location 
OOO7H and subtracting 8 from this number (8 pages = 2K 
bytes). The resulting number is the base page address of 


QCP. 


B. Store the command line in CIBUFF and the character 
count in CBUFF. The following information may help: 

ORG CPRLOC ;Base Address of ZCPR 

JMP CPR ;Enter ZCPR and Execute Default Cmd 

JMP CPR1 3Enter ZCPR and Don't Execute 
MBUFF: DB BUFLEN 3;Size of CIBUFF in bytes 
CBUFF: DS 1 j;Number of Bytes in Command Line 
CIBUFF: DS BUFLEN ;Buffer for Command Line 

DS 1 ;Buffer for Ending 0 (set by ZCPR) 
CIBPTR: DS 2 ;Address of CIBUFF (set by ZCPR) 


Cc. Qbtain the User/Disk Flag. Location OOO4H contains 
this number, but the user may select a flag of his choice. 
This flag is one byte long, and the high-order nibble (4° 
bits) contains the user number and the low-order nibble 
contains the disk number from which to process the command. 


The User/Disk Flag must be passed to QCP in the C Register. 


D. When ready, transfer control to QCP to process the 


command by JMPing to the base address of QCP. The first JMP 
in the JMP table given above is at this address. At this 
time, QCP will log in the user and disk in the User/Disk 


Flag and process the Command Level 3 Command Line. 
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QP/M 2.7 Interface Guide 


QP/M 2.7 is a superset of CP/M 2.2. It is intended to 
uses a Z80 or NSC-800 


upgrade any CP/M system which 
microprocessor, to a faster, more powerful operating system. 


Original CP/M packages include the CCP (Command Control 
Processor) and BDOS (Basic Disk Operating System). The CP/M 2.2 
CCP has been totally replaced by an upgraded version called QCP 

CP/M 2.2 BDOS has 


which includes a most important TIME command; 
been replaced by QP/M 2.7 QDOS. Two unique features appear in 
QDO0S: Drive/User Search whenever a file is opened, and‘automatic 
time/date stamping of files. CP/M 2.2 BIOS (Basic Input/Output 
need not be changed. In order to use the time/date 
either 


anew vector (called TIMDAT) must be added, 


System) 
to return the current time and date. 


capability, 


within BIOS or elsewhere, 
Specific procedures can be found in this documentation. 
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Function 0: System Reset 


Function 0 (System Reset) returns control to the QP/M 
operating system at the QCP level. The QCP will re-initialize 
the disk subsytem by selecting and logging-in disk drive A. 
Funetion 0 has exactly the same effect as a jump to location 
BOOT (usually at memory location O000H). 
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Function 1: Console Input 


| ------------------------------- tence nee nee oe | 


| Register C: 01H | Register A: ASCII Character | 


Function 1 (Console Input) reads the next console character 
into register A. All printable characters, characters with high- 
bit set, carriage return, linefeed, and dackspace (CTRL+H) will 
be echoed to the console output. Tab characters (CTRL+I), 
although returned as a single character, will be expanded in 
columns of eight characters by console output. A check is made 
for CTRL+S; when tnis occurs, program execution is suspended 
(sereen display is frozen) until another character (except 
CTRL+C) is typed. Typing a CTRL+S immediately followed by a 
CTRL+C aborts program execution and forces a system reset. All 
otner control characters are returned, but not echoed. 
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Function 2: Console Output 


| Entry Parameters I Returned Value | 
|---------- alata telat tea tetatatatatetatatatal S elelestehatatatetatatetatatatateteteteteteteetatahetahetatatel | 
| Register C: 02H | NONE | 


| Register E: ASCII Character | | 


Function 2 (Console Output) sends the ASCII character in 
register E to the console. Tab characters (CTRL+I, ASCII value 
9) are expanded in columns of eight characters. During Console 
Output, the console is checked for any characters waiting. The 
character CTRL+S is immediately processed as described in Console 
Input; all other characters are either discarded OR the first 
non-CTRL+S character is held for the next console input depending 
on the QDOS configuration (see Installation Guide). 
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Function 3: Reader Input 


| Register C: 03H | Register A: ASCII Character | 


Function 3 (Reader Ihput) reads the next character from the 
logical reader into register A. Control will not return until a 
character has been read. 
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Function 4: Punch Output 


| Register C: O4H | NONE | 
| Register E: ASCII Character | | 


Function 4 (Punch Output) sends the character from register 
E to the logical punch device. 
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Function 5: List Output 


Returned Value 
ewe ewe we ee ewe mem ew we ew ew ee ew ew eee we ee + 
| Register C: OSH 
| Register &E: 


Function 5 


(List Output) sends the 
register & 


ASCII character in 
to the logical listing device. 
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Function 6: Direct Console |/O 


+ 
egister C: 06H | Register A: status (input and 
| 
| 
| 


aw 


egister E: OFFH (input) status only) 
-OR- OFEH (status) 
-OR- char (output) 


Funetion 6 (Direct Console Input/Output) is supported under 
QP/M for those specialized applications where unadorned console 
input and output .s required. Use of this function, in general, 
should be avoided as it bypasses all of QP/M's normal character 
functions such as detection of CTRL+S and tab expansion. 


Upon entry to function 6, register E either contains 
hexadecimal value OFF, denoting console input request, 
hexadecimal value OFE, denoting console status request, or any 
other character which denotes console output. 


If tne input value in register £ is OFFH, function 6 returns 
A= O00 if no character is ready, otherwise A contains the next 
console input enaracter. 


If the input value in register E is OFEH, function 6 returns 
A = 00 if no character is ready or OFFH if a cnaracter is ready; 
the character is not returned. 


If tne input value of E is neither OFFH nor OFEH, function 6 


assumes that register E contains a valid ASCII character wnien is 
sent to tne console. 
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Function 7: Get I/O Byte 


Function 7 (Get I/O Byte) returns the current value of 
the IOBYTE in register A. 
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Function 8: Set I/O Byte 


| Register Cs 
| Register E:; 


Function 
that given in 


08H | Register A: NONE | 


8 (Set I/O Byte) changes the system IOBYTE value to 
register E. 
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Function 9: Print String 


| Entry Parameters ] Returned Value | 
Rectal leteteiaietetestetatatetatatetatatatetatatetatetatatetates | colette I 
| Register C: 09H | (NONE) #*# 

| Register DE: String Address |*Register DE: Address of | 
| | 


| : terminating char 


Function 9 (Print String) sends the character string stored 
in memory at the location given by register pair DE to the 
console device. Tabs are expanded as in function 2, and cnecks 
are made for CTRL+S. When the string terminator character ("$", 
ASCII nexadecimal value 24) is encountered, control is returned 
to the calling progran. Upon exit, register pair DE points to 
the terminating character ("$" in QP/M). 
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Function 10: Read Console Buffer oO 


| Register C: OAH | Console Characters in Buffer | 
| Register DE: Buffer Address | | 


Function 10 (Read Console Buffer) reads a line of edited 
console input into a buffer pointed to by register pair DE. 
Console input is terminated when either a Carriage Return (ASCII 
hexadecimal value OD) or a Line Feed (ASCII hexadecimal value OA) 
is input or the buffer is full. The input buffer pointed to by 
DE takes the following form: 


DS: +0 +1 +2 +3 +4 +5 +6 +7 +8 ee +n 


where "mx" is the maximum numoer of characters which the buffer 

will hold (a val:e between 1 and 255), "ne" is the number of 
characters read (set by QDOS before return), followed by the oO 
characters read from the Console Input. Tf "ne" < "mx", then 
uninitialized positions follow the last character, denoted by 

"22?" in the above figure. 


The Read Console Buffer performs its function by reading 
characters from the Console Input, processing certain characters, 
and placing tne rest into the buffer. If the buffer fills before 
the termination character (return or line feed) is encountered, 
QD0S returns to tne calling program with tne full buffer. Exception 
enaracters wnicn are processed are not placed into the input 
ouffer; these are listed on the next page along with thneir 
function. 


TITrI-14 


QP/M 2.7 Interface Guide 


Function 10: Read Console Buffer 


(continued) 


Character Function 


etrl-C reboots (performs a System Reset) when 
encountered at the beginning of the line 

forces a physical end-of-line (Console Output 

is sent a new line character 


sequence) 
witnout terminating console input 


etrl-H (or 


delete) backspaces one character erasing that 


character from the console and input buffer 


ectrl-J (line feed) terminates the input line 

etrl-M (return) terminates the input line 

etr1l-R retypes the current line after new line 
cnaracter sequence is sent 

etrl-U removes current line after new line 

etrl-X 


backspaces to beginning of current line 


Note also that certain functions 
leftmost position (e.g. 
where the Read 


woich return the carriage to the 


etrl-X) do so only to the column position 
Console Buffer function started. 


QP/M does not support the 


"rubout ecno" metnod for the 
delete/rubout Key, 


out rather treats it identical to backspace. 
As all video terminals support either the oackspace key or tne 


rubout key and hnardcopy-only terminals have faded, 


this feature 
snould not be missed. 
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Function 11: Get Console Status 


| Entry Parameters | Returned Value | 
|------- eee rr nn ee nn een ener a a aaa el al atlanta etait 
| Register C: OBH | Register A: Console Status | 


Function 11 (Get Console Status) checks if a character has 
been typed at the console. If a character is ready, the 
hexadecimal value FF is returned in register A; otherwise, OOH is 
returned. 
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Function 12: Return Version Number 


Function 12 (Return Version Number) provides information 
which allows version-independent programming. A two-byte value 
is returned, with H = 00 designating CP/M and QP/M releases (H = 
01 for MP/M), and L = 00 for all releases previous to 2.0. CP/M 
2.0 returns a hexadecimal value 20 in register L, with subsequent 
version releases 21 and 22. Version number 27 designates QP/M. 
Using function 12, for example, you can write application 
programs wnich select between user-prompted time/date input or 
system fetch of time/date depending on which version of the 


operating system is resident. 


TII-17 


QP/M 2.7 Interface Guide 


Function 13: Reset Disk System 


| Entry Parameters | Returned Value | 
|------- ween nnn ---------------- tanern- en ----------------------- | 
| Register C: ODH | (NONE) # | 
| Register DE: FCB Address or l[*Register A: Submit Flag | 


Function 13 (Reset Disk System) is used to restore the file 
system to a reset state where all disks are set for both read and 
write, only disk drive A is selected, and the default DMA address 
is reset to BOOT+0080H. For example, this function can be used 
by an application program which requires a disk change without a 
system reboot. 


For more advanced users, function 13 does return information 
regarding the presence of a file starting with a "$". Register A 
is OFFH if any file of the form "$22772727?7.22?7" exists and OOH 
otnerwise. 
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Function 14: Select Disk 


| Entry Parameters | Returned Value | 
| ene en nn nn nnn nnn nnn renner Site | 
| Register C: OEH | (NONE) # | 
| Register E: _Disk Number |*Register A: Submit Flag | 


Function 14 (Select Disk) function designates the disk drive 
named in register E as the default disk for subsequent file 
operations, with E = 00H for drive A, 01H for drive B, and so- 
forth through OFH (15 decimal) for drive P. The drive is placed 
in an "on-line" status whicn subsequently activates that disk's 
directory until the next cold start, warm start, or disk system 
reset operation. If the disk media is changed while it is on- 
line, the drive immediately goes to a read/only status; a cold 
start, warm start, Reset Disk System, or Reset Drive function is 
required to return the disk to a read/write status. 

Tne disk number specified is register &£ is different from 
tne drive code specified in the FCB. FCB's which specify drive 
code zero (dr = QOH) automatically reference the currently 
selected drive. Drive code values of 1 through 16, however, will 
cause QP/M to ignore the selected default drive, and directly 
reference drives A through P. (Note that values O tnrougn 15 
reference drives A through P in the Disk Seles: function.) 


The Select Disk function, if performed immediately after a 
Reset Disk function, also returns a flag in tne A register 
indicating tne presence of a "$2727277727.272?" file on tnat disk« - 
OFFH is returned if a matching file is found, else OOH is 
returned. 
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Function 15: Open File 


| Register C: OFH | Register A: Directory Code 
| Register DE: FCB Address | | 


Function 15 (Open File) is used to activate a file which 
currently exists in the disk directory. QDOS scans the 
referenced disk directory for a match in positions 1 through 14 
of the FCB referenced (bytes "si" and "s2" are automatically 
zeroed), where an ASCII question mark ("?" —= value 3FH) matches 
any directory character in any of these positions. For normal 
Open File operations, no question marks are included and, 
further, byte "ex" of the FCB is set to zero before calling this 
function. 


Byte 0 of the FCB specifies the drive code. If "dr" = 00 
the default disk drive is selected. Drive codes "dr" = 0 
through 10d auto-select drives A through P, respectively. 


H, 
1H 


The default drive/user search feature within QDOS is ONLY 
activated when tne Open File function is called. 


During an Open File operation, QDOS first searches the disx 
directory of the current user area. If tne file is not found, 
QDOS then searches the directory of the default user area fora 
match (unless tne two user areas are identical OR default user 
search is disabled). However, a file not found in the current 
user area, but found in tne default user area, can only be opened 
for reading. Any attempt to write to a file tnat was opened 
under the default user area will produce tne message 


QDOS error on d: File R/O 


The FOB of a file which is spened ander tne defaults user 
area is tagged by QDOS for future disk operations. AS a result, 
a file can be read even if tne current user area and/or the 
default user area changes after a successful open. This tag also 
prevents disk write operations to the file even if the current 
user area has been changed to maten tne user number of tne fiie. 
To write to the file, it must be re-opened in tne user area where 
that file exists. 


If QDOS fails to find the file in either the currens 
default user area, it searcnes for tne file on the default dr: 
in the default user area (unless the defauit drive and curren 
drive are the same OR default drive search is disabled). Alt 
restrictions described for default user searcn also apply 25 
default drive search. 
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(continued) 


If a directory element is matched, the relevant directory 
information is copied into bytes dO through dn of the FCB, thus 
allowing access to the files through subsequent read and write 
operations. (Write operations are not allowed on files opened in 
the default drive and/or user area.) It should be noted that an 
existing file must not be accessed until a successful open 
operation is completed. Upon return, the Open File function 
returns a "directory code" with the value 0 through 3 if the open 
was successful, or OFFH (decimal 255) if the file cannot be 
found. If question marks are present in the FCB, then the first 
matecning FCB is activated. Also note that the current record 
("er") must be zeroed by the program if you want to aecess the 
file sequentially from the first record. 


The format of the FCB is shown below. 


FCB Format 


DE: +0 #1 +2 +3 +4 +5 +6 +7 +8 £94+10411412+134+144+15 +16 +17 +18 


Bytes Name Funetion 
00 dr Drive code (ourrent ¢drive=), isd, 223, 2272.-? 
91-08 f1-f£8 File name 
09-11 ti-t3 File extension 
12 ex Current extent number 
13 31 Used in QP/M for default drive/user taz 
(not used in CP/M) 
14 32 Set to 0 on call to Open, Wake, and Search; 
used in QP/M for read/write tag 
15 re Current extent record count 
16-31 d00-d15 Disk map 
32 er Current record for read/write 
33-35 r0-r2 Random record number 
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Function 16: Close File 


| Register C: 10H | Register A: Directory Code | 
| Register DE: FCB Address I ir | 


Function 16 (Close File) performs the inverse of the Open 
file function. If the FCB addressed by DE has been previously 
activated through an Open or Make function, the close function 
permanently records the new FCB in the referenced disk directory. 
The FCB matching process for the close is the same as the Open 
function. Tne directory code returned for a successful close 
operation will be 0, 1, 2, or 3, while a OFFH (decimal 255) will 
be returned if the file name cannot be found in the directory. 


A file need not be closed if only read operations have taken 
place. If write operations have occurred, however, the close 
operation is necessary to permanently record the new directory 
information. 


Closing a file which was opened under the default drive 
and/or user area will return a directory code of OFFH (decimal 
255), except when the file drive and user areas are the same as 
the current drive and user area. In either case, no close 
Operation is needed and the result is of no concern. 
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Function 17: Search for First 


| Register C: 11H | Register A: Directory Code | 
| Register DE: FCB Address ! | 


Funetion 17 (Search for First) scans the directory for a 
match with the file given by the FCB addressed by DE. The OFFH 
(decimal 255) is returned if the file is not found, otherwise 0, 
1, 2, or 3 is returned indicating the file is present. In the 
case where the file is found, tne current DMA buffer is filled 
with the record containing the directory entry, and relative 
starting position is A * 32 (i.e., ADD A Five times or RRC three 
times). Altnough not normally required for application programs, 
you can extract the directory information from the buffer at this 
position, if desired. 


An ASCII question mark ("2?", decimal 03, hexadecimal 3F) in 
any position "fi" though "ex" will matcn the corresponding field 
of any directory entry on the eitner the default or auto-selected 
disk drive. If tne "dr" field contains an ASCII question mark, 
tnen the auto-disk select function is disabied and the default 
disk is searched returning any entry, ailocated or free, 
belonging to any user number. (Normally, Searcn for First 
searcnes only the current user area.) If the "dr" field is not a 
question mark, tne "s2" byte is automatically zeroed and searcn 
is done on the default or auto-selected disk in the current 
drive/user area. 
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Function 18: Search for Next 


| Register C: 12H | Register A: Directory Code | 


Function 18 (Search for Next) is similar to the Search for 
First funetion, except that the directory scan continues from the 
last matched entry. Similiar to function 17, funetion 18 returns 
the decimal value 255 when no more directory items match. 
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Function 19: Delete File 


| Register C: 13H | Register A: Result Code | 
| Register DE: FCB Address I ' 


19 (Delete File) removes the files which match the 
FCB addressed by register pair DE. The filename and type may 
contain ambiguous references (i.e. question marks in various 
positions), but the drive select code cannot be ambiguous, as in 


Search for First and Search for Next functions. 


Function 


Function 19 returns a OFFH (decimal 255) if the referenced 
file or files cannot be found in the current user area, otherwise 


a value of OOH is returned. 
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Function 20: Read Sequential 


| Register C: 14H | Register A: Directory Code | 
| Register DE: FCB Address I: | 


Function 20 (Read Sequential) reads the next 128-byte record 
from a file into memory at the current DMA address, provided a 
previous Open or Make function activated the FCB addressed by 
register pair DE. The record is read from position "cer" of the 
extent, and the "cer" field is incremented to the next record 
position automatically. If the "er" field overflows, then the 
next logical extent is opened automatically and the "er" field is 
reset to zero in preparation for the next read operation. The 
value OOH is returned in the A register if the read operation was 
successful, while a non-zero value is returned if the read 
operation failed (read past end-of-file, etc.). 


If the file referenced has been opened in the default drive 


and/or user area, the rzad operation will automatically access 
the appropriate drive and/or user. 
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Function 21: Write Sequential 


| Register C: 15H | Register A: Directory Code | 
| Register DE: FCB Address | 


Function 21 (Write Sequential) writes the next 128-byte 
record at the current DMA address, provided a previous Open or 
Make function activated the FCB addressed by register pair DE. 
Tne record is read from position "cr" of the extent, and the "cr" 
field is incremented to the next record position automatically. 
If the "er" field overflows, then the next logical extent is 
opened automatically and the "cr" field is reset to zero in 
preparation for the next write operation. The value OOH is 
returned in the A register if the write operation was successful, 
while a non-zero value is returned if the write operation failed 


(e.g. full disk or directory). 


Write operations can take place into an existing file, in 
which case newly written records overlay those wnich already 


exist in the file. 


file opened under the default drive and/or user 


Note that a 
Any attempt to write will result in tne 


area can only de read. 
messaze 


QD0S error on d: File R/O 


In order to write to this file, one must re-open tne file under 
tne drive/user area in woicn that file resides. 
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Function 22: Make File 


| Register C: 16H | Register A: Directory Code | 
| Register DE: FCB Address ! | 


Function 22 (Make File) is similar to the Open File 
operation except that the FCB must name a file which does not 
exist in the currently referenced disk directory and user area 
(i.e., the one named explicitly by a non-zero "dr" code, 
otherwise the default disk). QDOS creates the file and 
initializes both the directory and main memory value to an empty 
file. 


The programmer must ensure that no duplicate file names 
occur, and a preceding Delete File operation is sufficient if 
there is any possibility that a duplication could occur. Upon 
return, register A = 0, 1, 2, or 3 if the operation was 
successful and OFFH (decimal 255) if unsuccessful due to no more 
directory space. 


Tne Make function also activates tae FCB, thus a subsequent 
Open File is not necessary. 
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Function 23: Rename File 


| Register C: 17H | Register A: Result Code | 
| Register DE: FCB Address | | 


Function 23 (Rename File) uses the FCB addressed by DE to 
change all occurrences of the file named in the first 16 bytes to 
the file named in the second 16 bytes. The drive code "dr" at 
position 0 is used to select the drive, while the drive code for 
the new file name at position 16 is ignored - tne drive is the 
same as the first file name (at position 0). Upon return, 
register A= 00H if the rename was successful, and OFFH (decimal 
255) if the first file name could not be found. 


Again, caution should be used in renaming files just as in 
Making files as no check is made to see if the file already 
exists. Having two files of the same name not only confuses 
QP/M, but renders the "individual" files useless. 
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Function 24: Return Login Vector 


| Register C: 18H | Register HL: Login Vector | 


SPSSCSSSSSSSSSFSSSFSSSSSSSSSSSSSSSPSSSFSFSSsSSSFSSSSSSSSSSSqSSSqzqszsszreozsa 


Function 24 (Return Login Vector) returns a 16-bit value in 
register pair HL, where the least significant bit of L 
corresponds to drive A and the most significant bit of H 
corresponds to drive P. A "0O" bit indicates that the drive is 
not on-line, while a "1" bit marks a drive that is actively on- 
line due to an explicit disk drive selection or an implicit 
select specified by a non-zero "dr" field of an FCB. 
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Function 25: Return Current Disk § / 


Entry Parameters 
| enn een nnn nn nn nn nn enn nn nnn nnn-- s ieclesietatetetetetetetatetatetatatetatetatetatatatatetetetetatel | 
| Register A: Current Disk | 


Function 25 (Return Current Disk) returns the currently 
selected default disk number in register A. The disk numbers 
range from 0 for drive A to 15 for drive P. 

! 
i 
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Function 26: Set DMA Address 


| Register C: 1AH | NONE | 
| Register DE: DMA Address | | 


Funetion 26 (Set DMA Address) sets the DMA address to the 
value specified in register pair DE. "DMA" is an acronym for 
Direct Memory Access, which although is not what actually happens 
in QP/M, is accurate for programming purposes. The DMA address 
in QP/M designates the location where the 128-byte data record 
resides before a disk write and after a disk read. The DMA 
address is automatically set to BOOT+0080H upon cold start, warm 
start, or disk system reset. The Set DMA function, however, can 
be used to change this value to address another area of memory. 
Tais new DMA address is used for all subsequent operations until 
the next Set DMA function, cold start, warm start, or disk system 
reset. 
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Function 27: Get Alloc Addr 


| Register C: 1BH | Register A: ALLOC Address | 


Function 27 (Get Alloc) returns the address of the 
allocation vector. The “allocation vector" is maintained in main 
memory for each on-line disk drive. Function 27 will return the 
base address of the allocation vector for the currently selected 
disk drive; however, the allocation information may de invalid if 
the selected disk drive has oveen marked read/only. 
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Function 28: Write Protect Disk 


Function 28 (Write Protect Disk) provides temporary write 
protection for the currently selected disk. Any attempt to write 
to this disk prior to a reboot, Function 13 (Reset Disk), or 
Function 37 (Reset Drive) produces the message: 


QDOS error on d: R/O 
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Function 29: Get R/O Vector 


| Register HL: R/O Vector Value | 


Function 29 (Get Read/Only Vector) returns a bit vector in 
register pair HL that indicates which drives have the temporary 
Similar to Return Login Vector (function 24), 


read/only bit set. 

the least significant bit of register L corresponds to drive A 
and tne most significant bit of register H corresponds to drive 
P. The R/O bit is set either by an explicit call to function 28, 
or by mechanisms within QP/M that detect disk changes. 
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Function 30: Set File Attributes 


| Register C: 1EH | Register A: Directory Code | 
| Register DE: FCB Address | | 


Funetion 30 (Set File Attributes) allows programmatic 
Manipulation of permanent indicators attached to files. 
Specifically, the R/O, System, and Archive attributes (t1', t2', 
and t3') can be set or reset. Register pair DE addresses an 
unambiguous file name (no question marks) with the appropriate 
attributes set or reset. Function 30 ‘searches for a match, then 
changes the matched directory entry to contain the selected 
indicators. Indicators f1' through f4t are not presently used, 
but may be useful for applications programs, since they are not 
involved in the matching process during file operations. 
Indicators f5' through f38' are reserved for future systems. 
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Function 31: Get DPB Addr 


| Register C: 1FH | Register HL: DPB Address I 


Function 31 (Get Addr) returns the address of the BIOS 
resident disk parameter block in register HL; this address has 
two explicit applications: disk parameter values can be extracted 
for display and space computation purposes, or transient programs 
can dynamically change the values of current disk parameters when 
the disk environment changes, if required. Normally, application 
programs will not use this function. 
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Function 32: Set/Get User Code 


3 
Register C: 20H | Register A: User Code (get) | 
Register £: OFFH (get) | -OR-= no value (set) | 

-OR- User Code (set) | | 


Function 32 (Set/Get User Code) allows an application 
program to change or interrogate the currently active user number 
by calling function 32. If register E = OFFH, then the value of 
the current user number is returned in the A register, whicn 


ranges from 0 to 31. If register E is not OFFH, tne current user 
number is then changed to the value in E (modulo 32). 
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Function 33: Read Random 


| Register C: 21H | Register A: Error Code | 
| Register DE: FCB Address | | 


Function 33 (Read Random) is similar to the sequential file 
read operation except that the read operation takes place ata 
particular record number selected by the 24-bit value constructed 
from the three byte field following the FCB (byte positions rO at 
33, ri at 34, and r2 at 35). This 24-bit value is stored with 
least significant byte first (r0), middle byte next (ri), and 
most significant byte last (r2). QP/M does not reference byte 
"r2", except in computing the size of the file. Byte "r2" must 
always be zero, since a non-zero value indicates overflow past 
the end of the file. 


Thus, the rO/ri1 byte pair is treated as a "word" value, 
which contains the record to read. This value ranges from 0 to 
65535 (O000H to FFFFH) providing access to any particular record 
of the maximal 8 megabyte file. Before you can process a file 
using random access, tne base extent (extent 0) must first be 
opened. Althougn the base extent may or may not contain any 
allocated data, this ensures that tne file is properly recorded 
in tne directory and is visibdle in directory requests. The 
selected record number is then stored into the random record 
field -70/ri), and QDOS is called to read the record. 


Upon return from a Read Random call, register A contains an 
error code (listed below) with OOH indicating tne operation was 
successful. In tne iatter case, the current DMA address contains 
the randomly accessed record. Note that contrary to tne 
sequential read operation, tne record number (re) is noz 
advanced. Thus, subsequent random read operations continu2 19 
read tne same record unless the bytes rd0/rl are enanged. 


Upon each Read Random operation, the logical extent an 
current record values are automatically set. Therefore, the Fii 
can be sequentially read or written, starting from the curren 
randomly accessed position. Note, however, that in this cas3 


3 
the last randomly read record will be re-read as you switcn ro 
random mode to sequential read, and the last record will oe re2- 
Written as you switch to a sequential write operation. of 
course, you can simply advance the random record position 
following each random read or write to obtain tne effect 937 3 


sequential I/O operation. 
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Function 33: Read Random 
(continued) | 


The error codes returned in register A following a random 
read are as follows: 


00 successful completion 

01 reading unwritten data 

02 (not used in random mode) 

03 cannot close current extent 

O4 seek to unwritten record 

05 (not returned in read mode) 

06 seek past physical end of disk 


. 


Error codes 01 and O4 occur whenever a random read operation 
accesses a data block which has not been previously written, or 
an extent which has not been created; both are equivalent 
conditions. Error code 03 does not normally occur under proper 
system operation, but can be cleared by simply re-reading, or re- 
opening extent zero, provided you are not using a physically 
write-protected disk. Error code 06 occurs whenever byte "r2" is 
non-zero under the current QDOS release. Normally, non-zero 
return codes can be treated as missing data, with a zero return 
code indicating success. 
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‘Function 34: Write Random 


| Register C: 22H | Register A: Error Jode | 
| Register DE: FCB Address | | 


Function 34 (Write Random) is initiated similar to the Read 
Random call, except that data is written to the disk from the 
current DMA address. Further, if the disk extent or data block 
which is the target of the write has not yet been allocated, the 
allocation will performed automatically before the write 
operation continues. Lixe tne Read Random operation, tne random 
record number is not changed as a result of the write. The 
logical extent number and current record positions of the FCB are 
set to correspond to the random record which is being written. 

Again, sequential read or write operations can commence 
following a random write, provided the currently addressed record 
is either read or rewritten again as the sequential operation 
pegins. Also like Function 33, you can simply advance the random 
record position following each write to get tne effect of a 
sequential write operation. 


The error codes returned by a random write are identical to 
the Read Random operation, except that error code 02 is not used, 
and error code 05 is used to indicate that a new extent cannot oe 
created due to directory overflow. 


00 successful completion 

01 reading unwritten data 

02 (not used in random mode) 

03 cannot close current extent 

o4 seex to unwritten resord 

05 cannot create new extent 

fee) seek past onysiecar <= of diac 
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Function 35: Compute File Size 


| Register Cs: 23H | Random Record Field Set | 
| Register DE: FCB Address | | 


When computing the size of a file, the register pair DE 
contains the address of the FCB in random mode format (bytes 
trot, "rit, and "r2" are present). The FCB contains an 
unambiguous file name to use for the directory scan. Upon 
return, the random record bytes contain the record address of tne 
record following the end of the file (virtual file size). a 
function 35 is called, and the byte "r2" is 01, then the file 
contains the maximum possible record count of 65536. Otherwise, 
bytes rO/ri1 constitute a 16-bit value (rO is the least 
significant byte and r1is the most significant byte) which is 
the file size in 128-byte records. 


Data can be appended to the end of an existing file by 
calling function 35 to set the random record position to the end 
of file, then performing a sequence of random writes starting at 
the preset record position. 


The virtual size of a file corresponds to the physical size 
only when the file was written sequentially. If the file was 
created in random mode and "holes" exist so that it is not 
continuous, ‘then the file may contain fewer records than the size 
indicates. For example, if only the last record of a 8 megabyte 
file was written in random mode (record number 65535), tne 
virtual size is 65536 records, although only one block of data 
nas actually been written. 
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Function 36: Set Random Record 


| Register C: 24H | Random Record Field Set | 
| Register DE: FCB Address | | 


Function 36 (Set Random Record) causes QDOS to automatically 
produce the random record position from a file which has been 
read or written sequentially to a particular point. QDOS 
examines the current extent and record number and produces the 
logical 16-bit record number in "ri" and "rO". "RO" contains the 
low part of tne word, "ri" contains the high part of the word, 
and "r2" is set to zero. 


A use for function 36 is when you switch from a sequential 
read or write over to random read or write. A file is 
sequentially accessed to a particular point in the file, a call 
to function 36 sets the record number, and subsequent random file 
operations continue from this point in the file. 
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Function 37: Reset Drive 


| Register C: 25H | NONE | 
| Register DE: Reset Vector | | 


Function 37 (Reset Drive) is used to selectively reset drive 
or drives currently on-line. This is an alternative to the Reset 
Disk System function allowing one to change disks without having 
to reset the DMA address and re-select the specific drive. 


The register pair DE contains a 16-bit vector which 
designates which drives to reset; similar to earlier functions, 
the least significant bit of E designates drive A and the most 
significant bit of D designates drive P. A "1" in the specific 
bit position resets that drive; a "0" has no effect on the drive 
status. 


Function 37 can be treated as a selective alternative to 


funetion 13 (Reset Disk System) or as the complement of function 
28 (Write Protect Dis«x). 
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Function 38: Get Time/Date 


| Entry Parameters | Returned Value | 
| -- nn nen nen nnn nen nner nnn born nnn noe nnn ne ne een | 
| Register C: 26H | Register A: Directory Code | 
| Register DE: FCB Address or | | 
| OOOOH | | 


Function 38 (Get Time/Date) returns either the current 
time/date or the time/date information for an unambiguous file 
name pointed to by the FCB. If register pair DE contains OOOOH, 
QDOS returns the current time/date. If register DE is non-zero, 
it is assumed to point to a valid file name and retrieves tne 
time/date information of that file. 


When interrogating the current time/date (register DE = 
OO00H), QDOS fills the first 6 bytes of the DMA buffer with the 
time/date information and returns a directory code of zero. The 


format of the current time/date is 


DMA: +0 +1 +2 +3 +4 +5 


(DMA values when current time/date requested) 


(Day values range from 1 to 31, months from 1 to 12, years from 
0 to 99, hours from 0 to 23, minutes and seconds from 0 to 59.) 


If the operating system nas not been configured for QP/M 
(time/date capability added), QDOS will fill the 6 bytes with 
zeroes. 


When iaterrogating the time/date of a valid rile sans 
(register DE = FCB address), QDOS fills tne IMA ouffer wita one 
record containing time/date information and returns a directory 
code in register A = 0, 1, 2, 3, 4, 5, 6, 7 decimal; QDOS returns 
OFFH (decimal 255) if either the file is not found or the disx is 
not time/date stamped. This directory code specifies the 
relative starting position of the time/date information and is A 
* 16 (i.e., ADD A four times) bytes from the start of tae DMA 
buffer. 


The format of tne time/date information for a fiie is 
slightly different than the current time’date vector as is snowna 
on tne next page. 
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Function 38: Get Time/Date 


(continued) 


Offset from start of file time/date entry 
(at Dir Code times 16 plus DMA address) 


+0 +1 +2 +3 +4 45 +6 +7 +8 +9 +10 +#11+12+13 +14 +15 
| *## Created **#* | #*#* Updated *##* | ** Archived ** | | 
|day!monlyr|hri[min|daylmonlyrjhr|[min|day|monl|yrlhr|min|reserved| 


Byte positions 0 through 5 specify the time/date the file was 
sreated under QP/M. Byte positions 6 through 9 contain the 
time/date of the last successful close following a file write 
operation while operating under QP/M. (Note that a QP/M disk 
operating under CP/M will not have this information updated.) 
Although not normally required for applications programs, bytes 
10 through 15 specify the time/date of the last QBACKUP 
successfully completed on tnis file. 


When QDOS returns a value of OFFH (255), then either that 
file does not exist on disk or the QP/M time/date file 
information is abdsent. Note that a disk must have been 
configured for operation under QP/M before time/date stamping 
takes place (via QSTAMP.COM or QSTAMPX.COM). 
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‘Function 39: Set File Time/Date 


i i apd et Ral. hl an dn ade | 
| Register C: 27H | Register A: Directory Code | 
| Register DE: FCB Address 


Function 39 (Set File Time/Date) performs the opposite 
function of function 38 (get time/date) on the designated file. 
Before calling this function, the DMA area should be initialized 
to the proper time/date information in the following format 


+7 +48 +49 +10 +£11412413 +14 +15 


| *#*#*# Created ### | #*#* Updated **#* | ** Archived ** | | 


|daylmonlyrlor|minildaylmonlyrlhrimin{daylmonlyrlnrimin|! OOH | 
Upon completion, QDOS returns the directory code in register 

A. Successful completion values range from A = 0 to 7 decimal 
while 255 decimal (OFFH) designates an unsuccessful operation. 
Unsuccessful completion occurs when either the file does not 


exist or the specified disk has not been time/date stamped for 
QP/M. 


Note that tne original time/date information for tne 


specifie file is destroyed and completely replaced by the 
information in tne DMA area. Care snould de taken when using 
tais function. 
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Function 40: Write Random Zero Fill 


| Register C: 28H | Register A: Error Code | 
| Register DE: FCB Address | | 


Function 40 (Write Random Zero Fill) is similar to function 
24 (Write Random) except that no data is actually written to the 
disk, but the block is allocated for future use. Of course, one 
could also use the Write Random (or Write Sequential) functions 
and obtain the same results. However, use of funetion 40 to 
allocate disk space is quicker as only a "write directory" 
function is performed instead of both "write data" and "write 
directory". 


The error codes returned by a Random Write are identical to 
the Write Random operation and are included below: 


00 successful completion 

01 reading unwritten data 

02 (not used in random mode) 

03 cannot close current extent 

O4 seek to unwritten record 

05 cannot create new extent 

06 seek past pnysical end of disk 
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Function 41: Set/Get Default Drive 


+ 

| Register C: 29H | Register A: Drive Code (get) | 
| Register E: OFFH (get) -OR- | -OR= no value (set) | 
| Drive Code (set) | l 


Function 41 (Set/Get Default Drive) can be called by an 
application program to change or interrogate the current default 
drive number. If register E = OFFH, then the value of the 
current default drive number is returned in the A register, which 
ranges from 0 to 14 (A=0, B=1, etc). If default drive search is 
disabled, a value of OFFH is returned. 

If the value in register E is not 255, then the default 
drive number is changed to the specified value in the E-register. 
Note that all values of default drive between 0 and 254 are 
accepted; however, only values between 0 and 14 activate the 


default drive search. ALL other default drive codes DISABLE the 
default drive search feature of QDOS. 


The default drive number is only used by QDOS during an Open 
File operation. 
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Function 42: Set/Get Default User 


| Entry Parameters | Returned Value | 


|] Register C: 2AH | Register A: User Code (get) | 
| Register E: OFFH (get) -OR- | -OR= no value (set) | 
| User Code (set) | | 


Function 42 (Set/Get Default User) can be called by an 
application program to change or interrogate the currently active 
default user number. If register E = OFFH, then the value of tne 
current default user number is returned in the A register, which 
ranges from 0 to 14 if active or OFFH if default user search is 
disabled. If register E is not OFFH, then the current default 
user number is changed to the specified value in the E-register. 
Note that all values of default user between 0 and 254 are 
accepted; however, only values between 0 and 14 aetivate the 
default user search. ALL other default user codes DISABLE the 
default user search feature of QDOS. 


The default user number is only used by QDOS during an Open 
File operation. 
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Function 43: Compute Free Space 


| Register C: 2BH | Register HL: Number of free | 
records (128 bytes) | 


Function 43 (Compute Free Space) returns the free space 
remaining on the current logged drive. The value returned is in 
physical records (128-bytes). This vector could be used, for 
example, by utility applications to determine if the remaining 
space on the logged drive is adequate for transferring or storing 
a file. If you wisn to determine the remaining space on another 
drive, you must first use the Select Disk (funetion 14) followed 
by a call to Compute Free Space. 
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B. QP/M Utility Patching Information 


This section is included for experienced users who wish to 


patch the QP/M utilities. It is possible to set all user- 
definable values to your preferred values by customizing 


programs QSTAMP(X), QPATCH, QSTAT, and QINSTALL. Any user 
wishing to customize any of the utilities should have working 


knowledge of DDT or any of the debugging programs. 
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B-1. QSTAMP/QSTAMPX 


When QSTAMP(X) time/date stamps a disk for use by QP/M, a 2k 
(4k) directory program (D.COM) is also written to the disk. 
QSTAMP(X) can be patched for these conditions: 


(1) Write another directory program to the disk 
(2) Don't write any program to the disk 
(3) Change the name cf D.COM (e.g., to XD.COM) 


In QSTAME, D.COM way be repiaced by any 2k or smaller 
directory preg Sets When using DDT, I{nsert) the new directory 
filename.COM, Rlesd) with offset 94EH, Glo) to location OOH, then 
SAVE xx pages using the ‘manlizied QSTAUP filename (SAVE 18 pages 
for QSTAMP). 


In QSTANPK, D.COM may be replaced by any 4k or smaller 
directory program, When esing DUT, I(asert) the new directory 
filename.COM, R(ead) with offset 94EH, S(usbsitute), change byte 
047B from 18 to the number of 126-byte records of your directory 
program, then end S(ubstitute) with a period (¢.) Next, G(o) to 
location OOH, then SAVE xx pages using the modified QSTAMPX 
filename (SAVE 26 pages for QSTAMPX). 


QSTAMP(X) can be modified so that NO directory program is 
written to disk. Using DDT, change byte 0448H from CD to C3, 
then SAVE xx filename.COM. 


. You can change the name of the D.COM file that QSTAMP(X) 
writes by changing the filename that is located at OA2DH. The 
name must be EXACTLY 8 uppercase characters (assumed extension 
of .COM); and must be padded with blanks to fill the 8 positions 
if the name is actually shorter. 


NOTE: The ‘QPATCH utility allows you to change certain parameters 
in the D.COM program. If you change the name of the directory 
‘program in QSTAMP(X) from D.COM to some other name, you should 
also change the name in QPATCH. Please note that the parameters 
QPATCH modifies only apply to the original QP/M D.COM programs. 
Any attempt to change D.COM parameters (within QPATCH) of other 
directory programs will have unpredictable results. 
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B-2. QPATCH 


The QPATCH initial settings and "Restore default settings” 
options set the default values for both QBACKUP.COM and D.COM. 
The locations of these values and value ranges are included 


below. 

Description ; Location 

QBACKUP 

Maximum user number - 1 . : 0128H 
(default: 14) : 

Lines per screer. w of BR 01298 


(default: 24) 


D (2k or 4k) 
Lines to display before pause O1LEH 
(default: 24) - . 


roe 


File separator characte OLIFH 
(defaults: ':') : : : 

Width of screen in columns 01208 
(default: 04) 

Show user number O121H 
(default: OFFH) 

Show SYStem files : 0122H 
(default: OFFH) . 

Show date/time 0123H 
(default: 0) 

Reset before directory 0124H 
(default: 0). 

Show .LBR files - 0125H 
(default: 0) 

D (4k) 

Maximum drive + 1 ; 0126H 
(default: 16) ; : 

Maximum user + 1] 0127H 


(default: 16) 


Range 


O0.through 14. 


‘16 through 80 


16 through 80 


*& 


03 for <80; 04 for 80+ 


OFFH to show; otherwise 0 


OFFH 


~ OFEH 


OFFH 


QFFH 


to 


to 


to 


to 


show; otherwise 0 
show; otherwise 0 
reset; otherwise 0 


show; otherwise 0 


1 through -16 (for A-=- P) 


1 through 16 (for 0 -' 15) 


The names of the files that QPATCH modifies can also be 
altered, if you have changed the names of the original QP/M 
utilities. The names are EXACTLY 8 uppercase characters (assumed 
extension of .COM); the names MUST be padded with blanks to fill 


the 8 positions if the name is actually shorter. 


Description Location 
2k Directory program 0103H 
4k Directory program O10BH 
Backup program 011348 
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B-3. .QINSTALL 


. . Whenever a system is installed with 'QINSTALL, default values 
for the QCP are used unless the user specifically enters a new 
value. These default values can be customized to suit your 

‘tastes; patching. locations are listed-in-the-table below. NOTE 
that two consecutive locations must be changed ag QINSTALL uses 
the first as the actual value and.the second for restoring 
default settings. For example, in "Suppress user number ... ", 


both locations Oi04H and O105H mea be changed to the value 
desired. . 


Description Starting Location ‘Values 
Suppress user number 3 
when user is zero OL03H =. OCDR: show user 

(default: OC4H) GOGH: do not show user 

Screen size in lines OLOSH * ¥ 5 Range frow 16 to 80 dec. 
(default: 24 dec.} Soe ; 

Remote Access Systeu 010748 OCzH: not.a RAS 
(default: O0C2H) OC3H: operating as RAS 


Pause when screen fuli fy 


during TYPE O109H O26H: pause normally 
(default: 028H) ' "020K: no pause normally #) 
Top-of-form character O10BH aes * 
(default: 12 dec.) a: 
CP/M SUBMIT prompt OLODH 3.7 — Character + 80H (high bit set) 
(default: '$'+80H) Huby Tat i 
System prompt O1LOFH Character + 80H (high bit set) 


(default: '>'+80H) 
Maximum user number 0111H -is Range 0 through 15 
(default: 15) : 
Show SY¥Stem files beg aos 
in DIR listing Ol1l3H - OOOH: do not-show 


(default: O080H) O80H: show system files 

Separator character for DIR 

and ERA file listing O115H * 

(default: ':') 

Initial default drive Q117H Range O through 14 
(default: 0) 

Initial default user O119H Range 0 through 14 
(default: 0) 

Default drive/user locn OLLBH « WORD (16-bit) locn 
(default: 0008H) (NOTE: 4 bytes to fix) 
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B-4. QSTAT Seth Oa 


The logical. and physical device names used: in QSTAT. are 
those originally defined by Digital Research. However, any. of 
the names can':be’ altered by consulting the table below. .A 
MAXIMUM of 6 characters are: allowed for the name which ‘MUST. end 
in a colon. (:) and be in uppercase. . The ‘physical names -are 
grouped with the corresponding logical devices. ~ : = tg 


Description Location of Name 
Logical CON: OL96H 
physical TTY: OLIEH- . 
physical CRT: Q1244n- - oa 
physical BAT: O12AK ec 
physical UCLi-guy 5. OL30H %. . VRS Bek = 
Logical RDR: «#3 % 2+ O19CH 2°" eee F oat ets 
physical TTY: 0136H Pre Re) Cate I Meee tact 
physical PTR: = OL3CH 208 a a 
physical URIs 5 2 0142H ei ; 
physical UR2: 0148H ae Bae ee ae SS 
Logical PUN: . - - Q1A2H fu A 
physical TTY:. Ol4EH ¢§: : a ie 
physical PTP: 0154H PES 
physical UPl:= . : OLSAH 
physical UP2: 0160H 
Logical LST: O1LA8H 
physical TTY: «© .: 0166H 
physical CRT: 016CH 
physical LPT: 01728 
physical UL1: «»: .: . O178H 
‘es ” * ry he . 
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QP/M Supplements 


c. ap/M NOTES 


This séction is a: col, éett ox. of observations (and fixes 
where applicable) to.various programs while opérating under QP/M. 
Some programs may behave strangely under QP/M When the default 
drive and/or user‘séarch capability is enabled. Note that the 
fixes to programs shown below are oniy to resolve drive/user 
search side effects; if both default drive and usér are disabled, 
any strange ‘activity should disappear, 


oo 


ED. com (for ces a2) 


ED.COH done not work-with QP/h. ED. COM modifies the same 
bytes within the FCB which QF /M uses for drive/user search and 
'file written' flag. 


5 tog, OH EO eee 
PIP.COM (for CF/M 2.2) 


When transferring a file, PIP. ‘etree ‘transfers ‘the file under 
another extension (.$$$) at which time it checks if the 
‘destination: file is.reéead- onl-y:. This check ‘is doe with an Open 
“File opératton. Even though that particular file may not exist 
om the Serena bigt. PIP may respond with 


DESTINATION Is R/O, ‘DELETE? (Y/N) 


If this ‘Happens, £t is. iseaute ‘phat file exists in one of the 
_default:areas and is’ read/only. ‘in. that area and PIP has picked up 
that information ‘(unaware-of the, search feature). There are two 
solutions to this:. (1) disable default. drive. and’user areas or 
(2) use QPIP for transfers. 


Oe 


ws. CoM 


- Most WordStar programs. were ‘fnitially configured to search 
_ drive A-for ‘the’ ‘overlay files. if, ‘they. could not: be found on the 
current drive. Since WordStar. always. “specifies; the drive in the 
‘FCB, drive search is disabled; this ‘leads. to‘problems if, for 
‘example; : ‘you are ‘editing a file.on drive A. when WordStar is 
running from drive B. Even if the. default drive is.B, WordStar 
will” ‘only. veoh ta drive A for the overlays and-will-not. ‘figd them. 


Whenever. ‘WordStar edits a file, WordStar: eréates a temporary 
file for the’ actual edit. When WordStar-saves:the edited file, 
the original “File is renamed to ‘file. BAK": andithe..temporary file 
is renamed “to Tey1et. ‘Consequently, vevery® timesyou edit/save a 
a a new created/updated date will appear in-the directory. 
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